ensure zarr notebook is rendered, add cell metadata for large outputs

Author: scottyhq

_toc.yml

@@ -44,6 +44,7 @@ parts:
           - file: intermediate/indexing/boolean-masking-indexing.ipynb
       - file: intermediate/hierarchical_computation.ipynb
       - file: intermediate/xarray_and_dask
+      - file: intermediate/intro-to-zarr.ipynb
       - file: intermediate/xarray_ecosystem
       - file: intermediate/hvplot
       - file: intermediate/remote_data/index

intermediate/intro-to-zarr.ipynb

@@ -67,8 +67,16 @@
    "outputs": [],
    "source": [
     "import zarr\n",
+    "import pathlib\n",
+    "import shutil\n",
     "\n",
-    "z = zarr.create_array(shape=(40, 50), chunks=(10, 10), dtype='f8', store='test.zarr')\n",
+    "# Ensure we start with a clean directory for the tutorial\n",
+    "datadir = pathlib.Path('../data/zarr-tutorial')\n",
+    "if datadir.exists():\n",
+    "    shutil.rmtree(datadir)\n",
+    "\n",
+    "output = datadir / 'test.zarr'\n",
+    "z = zarr.create_array(shape=(40, 50), chunks=(10, 10), dtype='f8', store=output)\n",
     "z"
    ]
   },
@@ -188,20 +196,28 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "14",
-   "metadata": {},
+   "metadata": {
+    "tags": [
+     "scroll-output"
+    ]
+   },
    "outputs": [],
    "source": [
-    "!tree -a test.zarr"
+    "!tree -a ../data/test.zarr"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
    "id": "15",
-   "metadata": {},
+   "metadata": {
+    "tags": [
+     "scroll-output"
+    ]
+   },
    "outputs": [],
    "source": [
-    "!cat test.zarr/zarr.json"
+    "!cat ../data/test.zarr/zarr.json"
    ]
   },
   {
@@ -330,7 +346,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "c = zarr.create_array(shape=(200, 200, 200), chunks=(1, 200, 200), dtype='f8', store='c.zarr')\n",
+    "output = datadir / 'c.zarr'\n",
+    "c = zarr.create_array(shape=(200, 200, 200), chunks=(1, 200, 200), dtype='f8', store=output)\n",
     "c[:] = np.random.randn(*c.shape)"
    ]
   },
@@ -351,7 +368,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "d = zarr.create_array(shape=(200, 200, 200), chunks=(200, 200, 1), dtype='f8', store='d.zarr')\n",
+    "output = datadir / 'd.zarr'\n",
+    "d = zarr.create_array(shape=(200, 200, 200), chunks=(200, 200, 1), dtype='f8', store=output)\n",
     "d[:] = np.random.randn(*d.shape)"
    ]
   },
@@ -401,8 +419,6 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import zarr\n",
-    "\n",
     "z6 = zarr.create_array(\n",
     "    store={},\n",
     "    shape=(10000, 10000, 1000),\n",
@@ -485,7 +501,7 @@
    "id": "41",
    "metadata": {},
    "source": [
-    "```{info}\n",
+    "```{note}\n",
     "`.info_complete()` provides a more detailed view of the Zarr array, including metadata about the chunks, compressors, and attributes, but will be slower for larger arrays. \n",
     "```"
    ]
@@ -528,7 +544,11 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "45",
-   "metadata": {},
+   "metadata": {
+    "tags": [
+     "hide-output"
+    ]
+   },
    "outputs": [],
    "source": [
     "from pprint import pprint\n",
@@ -646,14 +666,6 @@
     "- [Scalable and Computationally Reproducible Approaches to Arctic Research](https://learning.nceas.ucsb.edu/2025-04-arctic/sections/zarr.html)\n",
     "- [Zarr Cloud Native Geospatial Tutorial](https://github.com/zarr-developers/tutorials/blob/main/zarr_cloud_native_geospatial_2022.ipynb)"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "54",
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {