{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "703c18a3",
   "metadata": {},
   "source": [
    "# Loading an existing multiverse\n",
    "\n",
    "An existing multiverse can be loaded in two different ways:\n",
    "\n",
    "1. As creating a multiverse (without running it) is cheap, one can simply run the same script/functions again, and comment out the `.run()` method.\n",
    "2. The multiverse can also be loaded from disk by simply providing its folder as a relative path (e.g. its name) or its absolute path (useful if it is loaded from a different file)\n",
    "\n",
    "Approach 1:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "5892663c",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Universe</th>\n",
       "      <th>Decision 1</th>\n",
       "      <th>Value 1</th>\n",
       "      <th>Decision 2</th>\n",
       "      <th>Value 2</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>Universe_1</td>\n",
       "      <td>strings</td>\n",
       "      <td>Hello</td>\n",
       "      <td>numbers</td>\n",
       "      <td>3.14</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Universe_2</td>\n",
       "      <td>strings</td>\n",
       "      <td>Hello</td>\n",
       "      <td>numbers</td>\n",
       "      <td>4.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Universe_3</td>\n",
       "      <td>strings</td>\n",
       "      <td>world</td>\n",
       "      <td>numbers</td>\n",
       "      <td>3.14</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>Universe_4</td>\n",
       "      <td>strings</td>\n",
       "      <td>world</td>\n",
       "      <td>numbers</td>\n",
       "      <td>4.00</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     Universe Decision 1 Value 1 Decision 2  Value 2\n",
       "0  Universe_1    strings   Hello    numbers     3.14\n",
       "1  Universe_2    strings   Hello    numbers     4.00\n",
       "2  Universe_3    strings   world    numbers     3.14\n",
       "3  Universe_4    strings   world    numbers     4.00"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from comet.multiverse import Multiverse\n",
    "\n",
    "forking_paths = {\n",
    "    \"strings\": [\"Hello\", \"world\"],\n",
    "    \"numbers\": [3.14, 4]\n",
    "}\n",
    "\n",
    "def analysis_template():\n",
    "    pass\n",
    "\n",
    "mverse = Multiverse(name=\"example_mv_load\")\n",
    "mverse.create(analysis_template, forking_paths)\n",
    "mverse.summary()\n",
    "#mverse.run()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7389ab0a",
   "metadata": {},
   "source": [
    "Approach 2:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "ccb1684e",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>Universe</th>\n",
       "      <th>Decision 1</th>\n",
       "      <th>Value 1</th>\n",
       "      <th>Decision 2</th>\n",
       "      <th>Value 2</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>0</th>\n",
       "      <td>Universe_1</td>\n",
       "      <td>strings</td>\n",
       "      <td>Hello</td>\n",
       "      <td>numbers</td>\n",
       "      <td>3.14</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>Universe_2</td>\n",
       "      <td>strings</td>\n",
       "      <td>Hello</td>\n",
       "      <td>numbers</td>\n",
       "      <td>4.00</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>Universe_3</td>\n",
       "      <td>strings</td>\n",
       "      <td>world</td>\n",
       "      <td>numbers</td>\n",
       "      <td>3.14</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>Universe_4</td>\n",
       "      <td>strings</td>\n",
       "      <td>world</td>\n",
       "      <td>numbers</td>\n",
       "      <td>4.00</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "     Universe Decision 1 Value 1 Decision 2  Value 2\n",
       "0  Universe_1    strings   Hello    numbers     3.14\n",
       "1  Universe_2    strings   Hello    numbers     4.00\n",
       "2  Universe_3    strings   world    numbers     3.14\n",
       "3  Universe_4    strings   world    numbers     4.00"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from comet import multiverse\n",
    "\n",
    "mverse = multiverse.load_multiverse(\"example_mv_load\")\n",
    "mverse.summary()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "94d39321",
   "metadata": {},
   "source": [
    "Note: If the previously created multiverse contains results, these can be visualized/analyzed after loading. However, if the multiverse specification was changed (e.g. by modifying the forking paths in the first approach), the previous results will only be removed/updated once `.run()` is called again."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "comet",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.0"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}