Embedding docs

Author: hombit

docs/tutorials/data_manipulation.ipynb

@@ -17,7 +17,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:41.890895Z",
+     "start_time": "2025-03-05T23:08:41.872743Z"
+    }
+   },
    "outputs": [],
    "source": [
     "import nested_pandas as npd\n",
@@ -31,7 +36,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:41.907431Z",
+     "start_time": "2025-03-05T23:08:41.902080Z"
+    }
+   },
    "outputs": [],
    "source": [
     "# Show one of the nested dataframes\n",
@@ -55,7 +65,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:41.933782Z",
+     "start_time": "2025-03-05T23:08:41.930296Z"
+    }
+   },
    "outputs": [],
    "source": [
     "# Directly Nested Column Selection\n",
@@ -72,7 +87,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:41.956770Z",
+     "start_time": "2025-03-05T23:08:41.953485Z"
+    }
+   },
    "outputs": [],
    "source": [
     "ndf[\"nested.t\"] + 100"
@@ -102,7 +122,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:41.992618Z",
+     "start_time": "2025-03-05T23:08:41.987910Z"
+    }
+   },
    "outputs": [],
    "source": [
     "# prepend lsst_ to the band column\n",
@@ -122,7 +147,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:42.016312Z",
+     "start_time": "2025-03-05T23:08:42.012009Z"
+    }
+   },
    "outputs": [],
    "source": [
     "# create a new \"corrected_t\" column in \"nested\"\n",
@@ -135,7 +165,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:42.037065Z",
+     "start_time": "2025-03-05T23:08:42.032519Z"
+    }
+   },
    "outputs": [],
    "source": [
     "# Show the first dataframe again\n",
@@ -159,7 +194,12 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:42.075674Z",
+     "start_time": "2025-03-05T23:08:42.061111Z"
+    }
+   },
    "outputs": [],
    "source": [
     "ndf[\"bands.band_label\"] = ndf[\"nested.band\"]\n",
@@ -176,11 +216,67 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "metadata": {},
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:42.132918Z",
+     "start_time": "2025-03-05T23:08:42.114796Z"
+    }
+   },
    "outputs": [],
    "source": [
     "ndf.add_nested(ndf[\"nested.band\"].to_frame(), \"bands_from_add_nested\")"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Embedding \"base\" column into nested column"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can also assign some \"base\" (non-nested) column to a nested column, which will be broadcasted to all nested dataframes with the values being repeated."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:42.165933Z",
+     "start_time": "2025-03-05T23:08:42.161684Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "ndf[\"nested.a\"] = ndf[\"a\"]\n",
+    "ndf[\"nested.a\"]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Or we can do some operations over the base columns first:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "ExecuteTime": {
+     "end_time": "2025-03-05T23:08:42.266923Z",
+     "start_time": "2025-03-05T23:08:42.262281Z"
+    }
+   },
+   "outputs": [],
+   "source": [
+    "ndf[\"nested.ab\"] = ndf[\"a\"] + ndf[\"b\"] * 2\n",
+    "ndf[\"nested.ab\"]"
+   ]
   }
  ],
  "metadata": {