documentation update

Author: ethaaalpha

examples/tutorials/demo-vipsession.ipynb

@@ -499,6 +499,84 @@
     "! tree {new_session.output_dir}"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Re-use a same dataset multiples times\n",
+    "You can re-use the same dataset multiples times. For that you will only need to keep the trace of where the inputs where uploaded on VIP.  \n",
+    "You will also need to not run `finish()` at the end of the session which has uploaded the dataset, it will prevent your dataset from being deleted.  \n",
+    "When you will reuse the data don't forget to adapt the paths in `inputs_settings` by using the path where they were initially uploaded."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "session = VipSession(\"session-A\")\n",
+    "session.upload_inputs(input_dir)\n",
+    "\n",
+    "inputs_settings = {\n",
+    "    \"file\": \"initial.file\",\n",
+    "    \"value\": 5\n",
+    "}\n",
+    "\n",
+    "input_folder_on_vip = session._vip_input_dir\n",
+    "print(f\"The dataset is located on VIP here: {input_folder_on_vip}\") # keep this information somewhere\n",
+    "\n",
+    "session.launch_pipeline(pipeline_id, input_settings)\n",
+    "session.monitor_workflows()\n",
+    "# no finish for the first session"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "session = VipSession(\"session-B\")\n",
+    "# do not forget to prepend your inputs !\n",
+    "adapted_inputs_settings = {\n",
+    "    \"file\" : f\"{input_folder_on_vip}/initial.file\", # reuse the stored inforation !\n",
+    "    \"value\": 5\n",
+    "}\n",
+    "session.launch_pipeline(pipeline_id, adapted_inputs_settings)\n",
+    "session.monitor_workflows()\n",
+    "session.finish()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "> [!NOTE]\n",
+    "> At the very end when you won't need the dataset anymore don't forget to run `VipSession(session-A).finish()` for cleaning the data from VIP servers.\n",
+    "> You must name your session like you named it for uploading your dataset."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "upload_session = VipSession(\"upload-session\")\n",
+    "upload_session.upload_inputs(input_dir)\n",
+    "# * running the session * #\n",
+    "\n",
+    "reuse_session_a = VipSession(\"reuse-session_a\")\n",
+    "# * reunning the session on the previous dataset * #\n",
+    "\n",
+    "reuse_session_b = VipSession(\"reuse-session_b\")\n",
+    "# * reunning the session on the previous dataset * #\n",
+    "\n",
+    "# finally deleting the dataset\n",
+    "VipSession(\"upload-session\").finish()"
+   ]
+  },
   {
    "attachments": {},
    "cell_type": "markdown",