Add to datasets.ipynb

Author: FBumann

docs/examples/datasets.ipynb

@@ -92,6 +92,53 @@
     "xpx(ds).line(facet_row=\"variable\", facet_col=\"city\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Configure Default \"variable\" Position\n",
+    "\n",
+    "By default, `\"variable\"` is placed as the **second** dimension so it maps to `color`. This keeps your first dimension (e.g., time) on the x-axis.\n",
+    "\n",
+    "You can change this globally with `config.set_options()`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Default: position=1 (second) -> variable goes to color\n",
+    "# Dimensions are: (time, variable, city)\n",
+    "print(\"Default dimension order:\", ds.to_array().dims)\n",
+    "xpx(ds).line(title=\"Default: variable as color (position=1)\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Position 0: variable goes first (x-axis) - usually not what you want!\n",
+    "with config.set_options(dataset_variable_position=0):\n",
+    "    fig = xpx(ds).line(title=\"position=0: variable on x-axis (probably not desired)\")\n",
+    "fig"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Position -1: variable goes last -> city gets color, variable gets line_dash\n",
+    "with config.set_options(dataset_variable_position=-1):\n",
+    "    fig = xpx(ds).line(title=\"position=-1: variable as line_dash\")\n",
+    "fig"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},