Update pasqal getting started tutorial to 1.0 (#5798)

- Tutorial was using PasqalConverter which was removed.
- Also added a section on how to insert so each operation
  is in its own moment.

Author: dstrain115

docs/hardware/pasqal/getting_started.ipynb

@@ -76,7 +76,9 @@
     "    print(\"installing cirq...\")\n",
     "    !pip install --quiet cirq\n",
     "    print(\"installed cirq.\")\n",
-    "    import cirq"
+    "    import cirq\n",
+    "import cirq_pasqal\n",
+    "from cirq_pasqal import ThreeDQubit, TwoDQubit, PasqalVirtualDevice, PasqalNoiseModel"
    ]
   },
   {
@@ -90,17 +92,6 @@
     "In this notebook, we show how to program a quantum circuit for Pasqal using cirq. The first step is to import cirq, and Pasqal custom classes. We use ``PasqalVirtualDevice`` to showcase how Cirq enforces Pasqal's devices' restrictions throughout the process."
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {
-    "id": "a43542246a0b"
-   },
-   "outputs": [],
-   "source": [
-    "from cirq_pasqal import ThreeDQubit, TwoDQubit, PasqalVirtualDevice, PasqalNoiseModel"
-   ]
-  },
   {
    "cell_type": "markdown",
    "metadata": {
@@ -177,8 +168,6 @@
    },
    "outputs": [],
    "source": [
-    "from cirq_pasqal.pasqal_device import PasqalConverter\n",
-    "\n",
     "# Initialize and create a circuit\n",
     "initial_circuit = cirq.Circuit()\n",
     "initial_circuit.append(cirq.CZ(p_qubits[0], p_qubits[1]))\n",
@@ -202,9 +191,7 @@
     "id": "aa25f2e644ce"
    },
    "source": [
-    "Notice that the `CX` gate, also called a `CNOT` gate is not valid on this device.  We can use a `PasqalConverter` object to convert it.\n",
-    "\n",
-    "This will convert the logical gates into native hardware gates.  When inserting into circuits designed for Pasqal devices, be sure to insert each operation into its own `Moment` (for example, using `cirq.InsertStrategy.NEW`)."
+    "Notice that the `CX` gate, also called a `CNOT` gate is not valid on this device.  We can use a `PasqalGateset` object with the built-in cirq method `cirq.optimize_for_target_gateset` to convert it.  This will convert the logical gates into native hardware gates.  "
    ]
   },
   {
@@ -215,17 +202,51 @@
    },
    "outputs": [],
    "source": [
-    "from cirq.circuits import insert_strategy\n",
-    "converter = PasqalConverter()\n",
+    "pasqal_gateset=cirq_pasqal.PasqalGateset(include_additional_controlled_ops=False)\n",
+    "pasqal_circuit = cirq.optimize_for_target_gateset(initial_circuit,\n",
+    "                                                  gateset=pasqal_gateset)\n",
+    "print(pasqal_circuit)\n",
     "\n",
-    "pasqal_circuit=cirq.Circuit(*[converter.pasqal_convert(op, keep=p_device.is_pasqal_device_op)\n",
-    "                              for op in initial_circuit.all_operations()],\n",
-    "                            strategy=cirq.InsertStrategy.NEW)\n",
+    "# Now the circuit validates correctly!\n",
+    "p_device.validate_circuit(pasqal_circuit)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "id": "DkHu3gfNpe2J"
+   },
+   "source": [
+    "When inserting into circuits designed for Pasqal devices, be sure to insert each operation into its own `Moment` (for example, using `cirq.InsertStrategy.NEW`).  You may need to do this in a seperate step, as in the below example that converts two simultaneous Hadamard gates."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "id": "YtXUHkTfpraF"
+   },
+   "outputs": [],
+   "source": [
+    "initial_circuit = cirq.Circuit()\n",
+    "initial_circuit.append(cirq.H(p_qubits[0]))\n",
+    "initial_circuit.append(cirq.H(p_qubits[1]))\n",
+    "print('Initial Circuit, does not pass validation:')\n",
+    "print(initial_circuit)\n",
+    "try:\n",
+    "    p_device.validate_circuit(initial_circuit)\n",
+    "except ValueError as e:\n",
+    "    # Uh oh!  This circuit does not pass validation.\n",
+    "    print(e)\n",
     "\n",
+    "pasqal_circuit = cirq.Circuit(initial_circuit.all_operations(),\n",
+    "                              strategy=cirq.InsertStrategy.NEW)\n",
+    "print('')\n",
+    "print('Converted Circuit, passes validation:')\n",
     "print(pasqal_circuit)\n",
     "\n",
     "# Now the circuit validates correctly!\n",
-    "p_device.validate_circuit(pasqal_circuit)\n"
+    "p_device.validate_circuit(pasqal_circuit)"
    ]
   },
   {
@@ -320,10 +341,11 @@
     "    yield grover_operator()\n",
     "        \n",
     "def generate_pasqal_grover():\n",
-    "    return cirq.Circuit(\n",
-    "        *[converter.pasqal_convert(op, keep=p_device.is_pasqal_device_op)\n",
-    "          for op in generate_grover()],\n",
-    "         strategy=cirq.InsertStrategy.NEW)\n",
+    "    pasqal_gateset=cirq_pasqal.PasqalGateset(include_additional_controlled_ops=False)\n",
+    "    grover_cicruit = cirq.optimize_for_target_gateset(cirq.Circuit(generate_grover()),\n",
+    "                                                      gateset=pasqal_gateset)\n",
+    "    return cirq.Circuit(grover_cicruit.all_operations(),\n",
+    "                        strategy=cirq.InsertStrategy.NEW)\n",
     "    \n",
     "device = PasqalVirtualDevice(control_radius=1.1, qubits=qs)        \n",
     "grover_circuit = generate_pasqal_grover()\n",
@@ -481,6 +503,7 @@
  ],
  "metadata": {
   "colab": {
+   "collapsed_sections": [],
    "name": "getting_started.ipynb",
    "toc_visible": true
   },