Add another spatialdata example notebook (#458)

* Add another spatialdata example notebook

* Update nb

Author: keller-mark

docs/notebooks/spatial_data_merfish_2.ipynb

@@ -0,0 +1,172 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "nbsphinx": "hidden"
+   },
+   "source": [
+    "# Vitessce Widget Tutorial"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Visualization of a SpatialData object"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Import dependencies\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "from os.path import join, isfile, isdir\n",
+    "from urllib.request import urlretrieve\n",
+    "import zipfile\n",
+    "\n",
+    "from vitessce import (\n",
+    "    VitessceConfig,\n",
+    "    ViewType as vt,\n",
+    "    CoordinationType as ct,\n",
+    "    CoordinationLevel as CL,\n",
+    "    SpatialDataWrapper,\n",
+    "    get_initial_coordination_scope_prefix\n",
+    ")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "data_dir = \"data\"\n",
+    "zip_filepath = join(data_dir, \"merfish_2.spatialdata.zarr.zip\")\n",
+    "spatialdata_filepath = join(data_dir, \"merfish_2.spatialdata.zarr\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "if not isdir(spatialdata_filepath):\n",
+    "    if not isfile(zip_filepath):\n",
+    "        os.makedirs(data_dir, exist_ok=True)\n",
+    "        urlretrieve('https://s3.embl.de/spatialdata/spatialdata-sandbox/merfish.zip', zip_filepath)\n",
+    "    with zipfile.ZipFile(zip_filepath,\"r\") as zip_ref:\n",
+    "        zip_ref.extractall(data_dir)\n",
+    "        os.rename(join(data_dir, \"data.zarr\"), spatialdata_filepath)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Configure Vitessce\n",
+    "\n",
+    "Vitessce needs to know which pieces of data we are interested in visualizing, the visualization types we would like to use, and how we want to coordinate (or link) the views."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "vc = VitessceConfig(\n",
+    "    schema_version=\"1.0.17\",\n",
+    "    name='MERFISH SpatialData Demo',\n",
+    ")\n",
+    "# Add data to the configuration:\n",
+    "wrapper = SpatialDataWrapper(\n",
+    "    sdata_path=spatialdata_filepath,\n",
+    "    # The following paths are relative to the root of the SpatialData zarr store on-disk.\n",
+    "    image_path=\"images/rasterized\",\n",
+    "    table_path=\"tables/table\",\n",
+    "    obs_feature_matrix_path=\"tables/table/X\",\n",
+    "    obs_spots_path=\"shapes/cells\",\n",
+    "    coordinate_system=\"global\",\n",
+    "    coordination_values={\n",
+    "        # The following tells Vitessce to consider each observation as a \"spot\"\n",
+    "        \"obsType\": \"cell\",\n",
+    "    }\n",
+    ")\n",
+    "dataset = vc.add_dataset(name='MERFISH').add_object(wrapper)\n",
+    "\n",
+    "# Add views (visualizations) to the configuration:\n",
+    "spatial = vc.add_view(\"spatialBeta\", dataset=dataset)\n",
+    "feature_list = vc.add_view(\"featureList\", dataset=dataset)\n",
+    "layer_controller = vc.add_view(\"layerControllerBeta\", dataset=dataset)\n",
+    "obs_sets = vc.add_view(\"obsSets\", dataset=dataset)\n",
+    "\n",
+    "vc.link_views_by_dict([spatial, layer_controller], {\n",
+    "    'spotLayer': CL([{\n",
+    "        'obsType': 'cell',\n",
+    "    }]),\n",
+    "}, scope_prefix=get_initial_coordination_scope_prefix(\"A\", \"obsSpots\"))\n",
+    "\n",
+    "vc.link_views([spatial, layer_controller, feature_list, obs_sets], ['obsType'], [wrapper.obs_type_label])\n",
+    "\n",
+    "# Layout the views\n",
+    "vc.layout(spatial | (feature_list / layer_controller / obs_sets));"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Render the widget"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "vw = vc.widget()\n",
+    "vw"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": []
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3 (ipykernel)",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.10.14"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 4
+}