section about netcdf4 backends

Author: eni-awowale

advanced/backends/intro-backends.ipynb

@@ -10,8 +10,8 @@
     "\n",
     ":::{admonition} Learning Goals\n",
     "- Learn about xarray's internal and external backends\n",
+    "- Learn how xarray selects backend engines\n",
     "- Learn how to specify backend engines\n",
-    "- Learn how make your own custom backend\n",
     ":::\n",
     "\n",
     "## What are Xarray Backends\n",
@@ -24,13 +24,28 @@
     ":::{admonition} See also\n",
     "You can learn more about xarray's [internal](https://tutorial.xarray.dev/advanced/backends/backends.html#links-to-internal-backends) and [external](https://tutorial.xarray.dev/advanced/backends/backends.html#links-to-external-backends-not-comprehensive) with our [guide](https://docs.xarray.dev/en/latest/user-guide/io.html) to backends.\n",
     "\n",
-    ":::\n",
-    "\n",
-    "## Why should you create your own Xarray backend?\n",
+    ":::"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "985ba2e6",
+   "metadata": {},
+   "source": [
+    "## Reading a dataset with the netCDF4 engine\n",
     "\n",
-    "- Allows you to use xarray's interface\n",
-    "- Easy integration with dask for lazy loading with Dask\n",
-    "- You don’t need to integrate any code in Xarray.\n"
+    "We can read in a dataset by selecting the \"netcdf4\" engine"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "d25101fb",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import xarray as xr\n",
+    "xr.tutorial.open_dataset('air_temperature', engine='netcdf4')"
    ]
   },
   {
@@ -50,7 +65,7 @@
    "id": "8548e481",
    "metadata": {},
    "source": [
-    "### Check for available backends\n",
+    "## Check for available backends\n",
     "\n",
     "We can get a list of our available engines with `list_engines`"
    ]
@@ -100,7 +115,7 @@
    "id": "992a1ed0",
    "metadata": {},
    "source": [
-    "### Reading without specifying engine\n",
+    "## Reading without specifying engine\n",
     "\n",
     "When opening a file or URL without explicitly specifying the ``engine`` parameter,\n",
     "xarray automatically selects an appropriate backend based on the file path or URL.\n",
@@ -717,7 +732,7 @@
    "id": "c5e4f362",
    "metadata": {},
    "source": [
-    "### Setting engine order\n",
+    "## Setting engine order\n",
     "\n",
     "You can customize the order in which netcdf4 backends are resolved using `xr.set_options(netcdf_engine_order=)`\n",
     "\n",
@@ -739,7 +754,7 @@
    "id": "ba077ebf",
    "metadata": {},
    "source": [
-    "### Specifying the wrong backend"
+    "## Specifying the wrong backend"
    ]
   },
   {
@@ -763,14 +778,6 @@
    "source": [
     "xr.tutorial.open_dataset('air_temperature', engine='pydap')"
    ]
-  },
-  {
-   "cell_type": "markdown",
-   "id": "1a798222",
-   "metadata": {},
-   "source": [
-    "## Creating your own Xarray Backend"
-   ]
   }
  ],
  "metadata": {