Make Task User Guide hidden code cell expandable (#114)

Author: tom-andersson

docs/user-guide/task.ipynb

@@ -62,13 +62,23 @@
     "In DeepSensor, a `Task` is a `dict`-like data structure that contains context sets, target sets, and other metadata.\n",
     "Before diving into the [](./task_loader) class which generates `Task` objects from `xarray` and `pandas` objects,\n",
     "we will first introduce the `Task` class itself.\n",
-    "In the code cell below, `task` is a `Task` object.\n",
-    "Printing a `Task` will print each of its entries and replace numerical arrays with their shape for convenience."
+    "\n",
+    "First, we will generate a `Task` using DeepSensor. These code cells are kept hidden because they includes\n",
+    "features that are only covered later in the User Guide. Only expand them if you are curious!"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 1,
+   "metadata": {
+    "ExecuteTime": {
+     "start_time": "2023-11-01T14:28:15.732009455Z"
+    },
+    "collapsed": false,
+    "tags": [
+     "hide-cell"
+    ]
+   },
    "outputs": [
     {
      "name": "stderr",
@@ -106,28 +116,19 @@
     "era5_ds = data_processor(era5_raw_ds)\n",
     "aux_ds, land_mask_ds = data_processor([auxiliary_raw_ds, land_mask_raw_ds], method=\"min_max\")\n",
     "station_df = data_processor(station_raw_df)"
-   ],
-   "metadata": {
-    "collapsed": false,
-    "tags": [
-     "hide-cell"
-    ],
-    "ExecuteTime": {
-     "start_time": "2023-11-01T14:28:15.732009455Z"
-    }
-   }
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 2,
    "metadata": {
-    "tags": [
-     "remove-cell"
-    ],
     "ExecuteTime": {
      "end_time": "2023-11-01T14:32:15.553656830Z",
      "start_time": "2023-11-01T14:32:15.548454739Z"
-    }
+    },
+    "tags": [
+     "hide-cell"
+    ]
    },
    "outputs": [],
    "source": [
@@ -136,6 +137,14 @@
     "task = task_loader(\"2016-06-25\", context_sampling=[52, 112], target_sampling=245)"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "In the code cell below, `task` is a `Task` object.\n",
+    "Printing a `Task` will print each of its entries and replace numerical arrays with their shape for convenience."
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 3,
@@ -178,6 +187,9 @@
   },
   {
    "cell_type": "markdown",
+   "metadata": {
+    "collapsed": false
+   },
    "source": [
     "**Exercise:**\n",
     "\n",
@@ -188,10 +200,7 @@
     "- The number of target sets\n",
     "- The number of observations in each target set\n",
     "- The dimensionality of each target set\n"
-   ],
-   "metadata": {
-    "collapsed": false
-   }
+   ]
   },
   {
    "cell_type": "markdown",
@@ -206,33 +215,40 @@
   },
   {
    "cell_type": "markdown",
+   "metadata": {
+    "collapsed": false
+   },
    "source": [
     "### Gridded data in Tasks\n",
     "\n",
     "For convenience, data that lies on a regular grid is given a compact tuple representation for the `\"X\"` entries:"
-   ],
-   "metadata": {
-    "collapsed": false
-   }
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 4,
-   "outputs": [],
-   "source": [
-    "task_with_gridded_data = task_loader(\"2016-06-25\", context_sampling=[\"all\", \"all\"], target_sampling=245)"
-   ],
    "metadata": {
-    "collapsed": false,
     "ExecuteTime": {
      "end_time": "2023-11-01T14:32:15.620494504Z",
      "start_time": "2023-11-01T14:32:15.570462444Z"
-    }
-   }
+    },
+    "collapsed": false
+   },
+   "outputs": [],
+   "source": [
+    "task_with_gridded_data = task_loader(\"2016-06-25\", context_sampling=[\"all\", \"all\"], target_sampling=245)"
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 5,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2023-11-01T14:32:15.628949091Z",
+     "start_time": "2023-11-01T14:32:15.611675646Z"
+    },
+    "collapsed": false
+   },
    "outputs": [
     {
      "name": "stdout",
@@ -249,23 +265,16 @@
    ],
    "source": [
     "print(task_with_gridded_data)"
-   ],
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2023-11-01T14:32:15.628949091Z",
-     "start_time": "2023-11-01T14:32:15.611675646Z"
-    }
-   }
+   ]
   },
   {
    "cell_type": "markdown",
-   "source": [
-    "In the above example, the first context set lies on a 141 x 221 grid, and the second context set lies on a 140 x 220 grid."
-   ],
    "metadata": {
     "collapsed": false
-   }
+   },
+   "source": [
+    "In the above example, the first context set lies on a 141 x 221 grid, and the second context set lies on a 140 x 220 grid."
+   ]
   },
   {
    "cell_type": "markdown",
@@ -306,17 +315,24 @@
   },
   {
    "cell_type": "markdown",
+   "metadata": {
+    "collapsed": false
+   },
    "source": [
     "Gridded data in a `Task` can be flattened using the `.flatten_gridded_data` method.\n",
     "Notice how the `\"X\"` entries are now 2D arrays of shape `(2, M)` rather than tuples of two 1D arrays of shape `(M,)`."
-   ],
-   "metadata": {
-    "collapsed": false
-   }
+   ]
   },
   {
    "cell_type": "code",
    "execution_count": 7,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2023-11-01T14:32:15.970618528Z",
+     "start_time": "2023-11-01T14:32:15.909066194Z"
+    },
+    "collapsed": false
+   },
    "outputs": [
     {
      "name": "stdout",
@@ -333,14 +349,7 @@
    ],
    "source": [
     "print(task_with_gridded_data.flatten_gridded_data())"
-   ],
-   "metadata": {
-    "collapsed": false,
-    "ExecuteTime": {
-     "end_time": "2023-11-01T14:32:15.970618528Z",
-     "start_time": "2023-11-01T14:32:15.909066194Z"
-    }
-   }
+   ]
   }
  ],
  "metadata": {