Changes to be committed:

	modified:   misc/notebooks/01_Data_Loading_Module_Use.ipynb

Author: gonfeco

misc/notebooks/01_Data_Loading_Module_Use.ipynb

@@ -225,7 +225,12 @@
    "id": "8ca4a398",
    "metadata": {},
    "source": [
-    "To load a discrete probability distribution we just need the function *load_probability*, which inside the **DL/data_loading** module. The input should be a numpy array with the probability distribution that we want to load into the quantum state. In this case the probability distribution is the variable *probability*. The output of the function is a **qlm** *AbstractGate* with arity *n*. "
+    "To load a discrete probability distribution we just need the function *load_probability*, which inside the **DL/data_loading** module. The inputs are:\n",
+    "\n",
+    "* numpy array with the probability distribution that we want to load into the quantum state (**MANDATORY**). In this case the probability distribution is the variable *probability*.\n",
+    "* id_name: string for giving a name to the Abstract Gate created by the function. If not name is provided then the cpu time will be added to the name.\n",
+    "\n",
+    "The output of the function is a **qlm** *AbstractGate* with arity *n*. "
    ]
   },
   {
@@ -237,36 +242,36 @@
    },
    "outputs": [],
    "source": [
-    "routine = load_probability(probability)"
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "9f2d5768",
-   "metadata": {},
-   "source": [
-    "Now, our quantum state has the form:\n",
-    "$$\\left[\\sqrt{p_0}|0\\rangle+\\sqrt{p_1}|1\\rangle+\\sqrt{p_2}|2\\rangle+\\sqrt{p_3}|3\\rangle+\\sqrt{p_4}|4\\rangle+\\sqrt{p_5}|5\\rangle+\\sqrt{p_6}|6\\rangle+\\sqrt{p_7}|7\\rangle\\right]$$\n",
-    "The corresponding circuit can be visualized directly passing the qlm routine *routine* to %qatdisplay."
+    "#With id_name provided\n",
+    "routine = load_probability(probability, 'toy')\n",
+    "#Display circuit representation\n",
+    "%qatdisplay routine --depth 0 --svg"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "c6b53c60",
+   "id": "55bce45d",
    "metadata": {
     "scrolled": true
    },
    "outputs": [],
    "source": [
+    "#No id_name provided\n",
+    "routine = load_probability(probability)\n",
+    "#Display circuit representation\n",
     "%qatdisplay routine --depth 0 --svg"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "5e4b04ac",
+   "id": "9f2d5768",
    "metadata": {},
    "source": [
+    "Now, our quantum state has the form:\n",
+    "\n",
+    "$$\\left[\\sqrt{p_0}|0\\rangle+\\sqrt{p_1}|1\\rangle+\\sqrt{p_2}|2\\rangle+\\sqrt{p_3}|3\\rangle+\\sqrt{p_4}|4\\rangle+\\sqrt{p_5}|5\\rangle+\\sqrt{p_6}|6\\rangle+\\sqrt{p_7}|7\\rangle\\right]$$\n",
+    "\n",
     "Last, we use the function *get_results* from **data_extracting** to obtain the probabilities loaded into the quantum circuit. By the quantum properties, what we are measuring is:\n",
     "\n",
     "\n",
@@ -351,7 +356,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "%qatdisplay routine --depth 1 --svg"
+    "%qatdisplay routine --depth 0 --svg"
    ]
   },
   {
@@ -360,8 +365,14 @@
    "metadata": {},
    "source": [
     "And the state now loaded in the circuit is:\n",
+    "\n",
     "$$\\dfrac{1}{\\sqrt{N}}|0\\rangle\\left[|0\\rangle+|1\\rangle+|2\\rangle+|3\\rangle+|4\\rangle+|5\\rangle+|6\\rangle+|7\\rangle\\right]$$\n",
-    "The next step is loading our array.  For that we have the function *load_array* inside **DL/data_loading** module, this function takes as first argument a normalised array, one which has norm infinity equal or less than $1$. It admits a second argument called *method*. By default this second argument it is set to *multiplexors*, but it can also have the value *brute_force*. This second option is much less efficient in terms of quantum gates."
+    "\n",
+    "The next step is loading our array.  For that we have the function *load_array* inside **DL/data_loading** module, this function takes following arguments:\n",
+    "\n",
+    "1. normalised array, one which has norm infinity equal or less than $1$. \n",
+    "2. argument called *method*. By default this second argument it is set to *multiplexors*, but it can also have the value *brute_force*. This second option is much less efficient in terms of quantum gates.\n",
+    "3. id_name: string for giving a name to the Abstract Gate created by the function. If not name is provided then the cpu time will be added to the name."
    ]
   },
   {
@@ -374,14 +385,39 @@
     "from QQuantLib.DL.data_loading import load_array"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "780d7469",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#Not Providing id_name\n",
+    "load_gate = load_array(f_normalised)\n",
+    "%qatdisplay load_gate --depth 0 --svg"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "b8411534",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#Providing id_name\n",
+    "load_gate = load_array(f_normalised, id_name='f')\n",
+    "%qatdisplay load_gate --depth 0 --svg"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
    "id": "253f68ae",
    "metadata": {},
    "outputs": [],
    "source": [
-    "routine.apply(load_array(f_normalised),register)"
+    "#Now apply the gate to the routine\n",
+    "routine.apply(load_gate, register)"
    ]
   },
   {
@@ -481,7 +517,7 @@
    "source": [
     "routine = qlm.QRoutine()\n",
     "register = routine.new_wires(n+1)\n",
-    "routine.apply(load_probability(probability),register[:n])\n",
+    "routine.apply(load_probability(probability, id_name='p(x)'),register[:n])\n",
     "%qatdisplay routine --depth 0 --svg"
    ]
   },
@@ -510,7 +546,7 @@
    "outputs": [],
    "source": [
     "f_root = np.sqrt(f_normalised)\n",
-    "routine.apply(load_array(f_root),register)\n",
+    "routine.apply(load_array(f_root, id_name='f(x)'),register)\n",
     "%qatdisplay routine --depth 0 --svg"
    ]
   },
@@ -1190,7 +1226,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.11"
+   "version": "3.9.9"
   }
  },
  "nbformat": 4,