begin docs

awennersteen · awennersteen · commit 9665a975f13d · 2025-02-14T18:36:27.000+01:00
diff --git a/docs/sphinx/targets/python/pasqal.py b/docs/sphinx/targets/python/pasqal.py
@@ -0,0 +1,36 @@
+import cudaq
+from cudaq.operator import *
+
+# This example illustrates how to use Pasqal's Fresnel device over Pasqal's cloud via CUDA-Q.
+
+cudaq.set_target("pasqal")
+
+# Define the 2-dimensional atom arrangement
+a = 5.7e-6
+register = []
+
+# Times for the piece-wise linear waveforms
+steps = [0.0, time_ramp, time_max - time_ramp, time_max]
+schedule = Schedule(steps, ["t"])
+# Rabi frequencies at each step
+omega = ScalarOperator(lambda t: omega_max if time_ramp < t < time_max else 0.0)
+# Global phase at each step
+phi = ScalarOperator.const(0.0)
+# Global detuning at each step
+delta = ScalarOperator(lambda t: delta_end
+                       if time_ramp < t < time_max else delta_start)
+
+async_result = evolve_async(RydbergHamiltonian(atom_sites=register,
+                                               amplitude=omega,
+                                               phase=phi,
+                                               delta_global=delta),
+                            schedule=schedule,
+                            shots_count=10).get()
+async_result.dump()
+
+## Sample result
+# ```
+# {
+#    counter : { 01010111:1 10101010:2 10101011:1 10101110:1 10110101:1 10110110:2 11010110:1 11110110:1 }
+# }
+# ```
diff --git a/docs/sphinx/using/backends/hardware/neutralatom.rst b/docs/sphinx/using/backends/hardware/neutralatom.rst
@@ -130,6 +130,63 @@ Submitting
 
 
 
+Pasqal
+++++++++++++++++
+
+Pasqal's QPU is an an analog quantum simulator
+https://quantum-journal.org/papers/q-2020-09-21-327/
+https://quantum-journal.org/papers/q-2022-01-24-629/
+
+.. _pasqal-backend:
+
+Setting Credentials
+```````````````````
+
+Use in Python
+https://github.com/pasqal-io/pasqal-cloud
+
+Alternatively, users can set the following environment variables.
+
+.. code:: bash
+
+  export PASQAL_TOKEN=<>
+
+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('pasqal')
+
+
+Due to the nature of the underlying hardware, this target only supports the 
+``evolve`` and ``evolve_async`` APIs.
+The `hamiltonian` must be an `Operator` of the type `RydbergHamiltonian`. Only 
+other parameters supported are `schedule` (mandatory) and `shots_count` (optional).
+
+For example,
+
+.. code:: python
+
+    evolution_result = evolve(RydbergHamiltonian(atom_sites=register,
+                                                 amplitude=omega,
+                                                 phase=phi,
+                                                 delta_global=delta),
+                               schedule=schedule)
+
+The number of shots for a kernel execution can be set through the ``shots_count``
+argument to ``evolve`` or ``evolve_async``. By default, the ``shots_count`` is 
+set to 100.
+
+.. code:: python 
+
+    cudaq.evolve(RydbergHamiltonian(...), schedule=s, shots_count=1000)
+
+To see a complete example for using QuEra's backend, take a look at our :doc:`Python examples <../../examples/hardware_providers>`.
+
 
 QuEra Computing
 ++++++++++++++++
diff --git a/docs/sphinx/using/examples/hardware_providers.rst b/docs/sphinx/using/examples/hardware_providers.rst
@@ -114,7 +114,18 @@ This experiment is performed on ORCA's backends by the code below.
 
    .. literalinclude:: ../../targets/cpp/orca.cpp
       :language: cpp
-      
+
+Pasqal
+==================================
+
+The following code illustrates how to run kernels on Pasqal's backends.
+
+.. tab:: Python
+
+   .. literalinclude:: ../../targets/python/pasqal_basic.py
+      :language: python
+
+
 Quantinuum
 ==================================
 
