From fcf12812e6c2cd28b150a1168bbdfc9f1f87cf74 Mon Sep 17 00:00:00 2001 From: Pradnya Khalate Date: Fri, 13 Mar 2026 16:10:41 -0700 Subject: [PATCH 1/3] [docs] [pasqal] Re-organize the "submitting" section Signed-off-by: Pradnya Khalate --- .../using/backends/hardware/neutralatom.rst | 77 ++++++++++++------- 1 file changed, 51 insertions(+), 26 deletions(-) diff --git a/docs/sphinx/using/backends/hardware/neutralatom.rst b/docs/sphinx/using/backends/hardware/neutralatom.rst index 09b1f1d5769..5849b337188 100644 --- a/docs/sphinx/using/backends/hardware/neutralatom.rst +++ b/docs/sphinx/using/backends/hardware/neutralatom.rst @@ -142,13 +142,11 @@ arrays to bring a practical quantum advantage to its customers and address real- The currently available Pasqal QPUs are analog quantum computers, and one, named Fresnel, is available through our cloud portal. -In order to access Pasqal's devices you to sign up for an account on +In order to access Pasqal's devices you need to sign up for an account on `Pasqal's cloud platform `__. - -Although a different SDK, `Pasqal's Pulser library `__, is a good -resource for getting started with analog neutral atom quantum computing. For support you can also join the `Pasqal Community `__. - +`Pasqal's Pulser library `__ is also a good +resource for getting started with analog neutral atom quantum computing. .. _pasqal-backend: @@ -180,27 +178,12 @@ Alternatively, users can set the following environment variables directly. export PASQAL_AUTH_TOKEN=<> export PASQAL_PROJECT_ID=<> -Pasqal via QRMI -``````````````` - -CUDA-Q's ``pasqal`` target for routing Pasqal jobs through the vendor agnostic -Quantum Resource Management Interface (QRMI), by specifying ``machine`` as ``qrmi``. -This target enables integration with resource managers like Slurm for scheduling. -Select the Pasqal backend with the ``--qpu`` option in ``sbatch`` and let QRMI -handle submission. - - -For this route, credentials and project id are read by QRMI using either -``~/.pasqal/config`` or other methods supported by your cluster's QRMI setup. - -The job submission process is the same as for the ``pasqal`` target. For example: +Submitting via Pasqal Cloud (Direct) +```````````````````````````````````` - -Submitting -````````````````````````` .. tab:: Python - The target to which quantum kernels are submitted + The target to which quantum kernels are submitted can be controlled with the ``cudaq.set_target()`` function. .. code:: python @@ -208,14 +191,20 @@ Submitting cudaq.set_target('pasqal') - This accepts an optional argument, ``machine``, which is used in the cloud platform to - select the corresponding Pasqal QPU or emulator to execute on. + This accepts an optional argument, ``machine``, which selects the + Pasqal QPU or emulator to execute on. See the `Pasqal cloud portal `__ for an up to date list. The default value is ``EMU_MPS`` which is an open-source tensor network emulator based on the Matrix Product State formalism running in Pasqal's cloud platform. You can see the documentation for the publicly accessible emulator `here `__. - To target the QPU use the FRESNEL machine name. Note that there are restrictions + To target the QPU, pass the ``FRESNEL`` machine name: + + .. code:: python + + cudaq.set_target('pasqal', machine='FRESNEL') + + Note that there are restrictions regarding the values of the pulses as well as the register layout. We invite you to consult our `documentation `__. Note that the CUDA-Q integration currently only works with `arbitrary layouts `__ @@ -299,6 +288,42 @@ Submitting To see a complete example, take a look at :ref:`Pasqal examples `. +Submitting via QRMI +```````````````````` + +.. note:: + + QRMI mode is available only in Linux x86_64 builds of CUDA-Q, + via the Python wheel or source build. + +CUDA-Q's ``pasqal`` target supports routing Pasqal jobs through the vendor-agnostic +Quantum Resource Management Interface (QRMI), by specifying ``machine`` as ``qrmi``. +This enables integration with resource managers like Slurm for scheduling. +Select the Pasqal backend with the ``--qpu`` option in ``sbatch`` and let QRMI +handle submission. + +For this route, credentials and project ID are read by QRMI using either +``~/.pasqal/config`` or other methods supported by your cluster's QRMI setup. + +The job submission process is the same as for the ``pasqal`` target. + +.. code:: bash + + export SLURM_JOB_QPU_RESOURCES=EMU_FREE + +.. tab:: Python + + .. code:: python + + cudaq.set_target('pasqal', machine='qrmi') + +.. tab:: C++ + + .. code:: bash + + nvq++ --target pasqal --pasqal-machine qrmi src.cpp + + .. note:: Local emulation via ``emulate`` flag is not yet supported on the `pasqal` target. From f24f65c5693cfd952caab54a7f4aa41024ddab07 Mon Sep 17 00:00:00 2001 From: Pradnya Khalate Date: Sat, 14 Mar 2026 09:32:45 -0700 Subject: [PATCH 2/3] * Addressing review comment Signed-off-by: Pradnya Khalate --- docs/sphinx/using/backends/hardware/neutralatom.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/sphinx/using/backends/hardware/neutralatom.rst b/docs/sphinx/using/backends/hardware/neutralatom.rst index 5849b337188..1be9c76b14d 100644 --- a/docs/sphinx/using/backends/hardware/neutralatom.rst +++ b/docs/sphinx/using/backends/hardware/neutralatom.rst @@ -145,8 +145,6 @@ portal. In order to access Pasqal's devices you need to sign up for an account on `Pasqal's cloud platform `__. For support you can also join the `Pasqal Community `__. -`Pasqal's Pulser library `__ is also a good -resource for getting started with analog neutral atom quantum computing. .. _pasqal-backend: From 15fcb984b4801ee18f2be1b9e3deb19c7bf3dec8 Mon Sep 17 00:00:00 2001 From: Pradnya Khalate Date: Mon, 16 Mar 2026 14:00:01 -0700 Subject: [PATCH 3/3] * Rewording per review comment. Signed-off-by: Pradnya Khalate --- docs/sphinx/using/backends/hardware/neutralatom.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sphinx/using/backends/hardware/neutralatom.rst b/docs/sphinx/using/backends/hardware/neutralatom.rst index 1be9c76b14d..5e298194ccf 100644 --- a/docs/sphinx/using/backends/hardware/neutralatom.rst +++ b/docs/sphinx/using/backends/hardware/neutralatom.rst @@ -297,8 +297,8 @@ Submitting via QRMI CUDA-Q's ``pasqal`` target supports routing Pasqal jobs through the vendor-agnostic Quantum Resource Management Interface (QRMI), by specifying ``machine`` as ``qrmi``. This enables integration with resource managers like Slurm for scheduling. -Select the Pasqal backend with the ``--qpu`` option in ``sbatch`` and let QRMI -handle submission. +When configuring Slurm, select the Pasqal backend with the ``--qpu`` option in ``sbatch`` +and let QRMI handle submission. For this route, credentials and project ID are read by QRMI using either ``~/.pasqal/config`` or other methods supported by your cluster's QRMI setup.