Update Xarray in 45 min (#240)

dcherian · web-flow · commit 321706a311df · 2024-02-18T17:59:23.000-07:00
* Update Xarray in 45 min

* Fix errors

* Small updates

* Remove logo in most places
diff --git a/advanced/accessors/01_accessor_examples.ipynb b/advanced/accessors/01_accessor_examples.ipynb
@@ -117,7 +117,7 @@
     "\n",
     "Perhaps you find yourself running similar code for multiple xarray objects or across related projects. By packing your code into an extension, it makes it easy to repeat the same operation while reducing the likelihood of [human introduced] errors.\n",
     "\n",
-    "Here we wrap the reorganization of InSAR ice velocity data illustrated in [this tutorial](https://tutorial.xarray.dev/data_cleaning/ice_velocity.html?highlight=ice_velocity) into a custom Xarray extension that makes it easy to re-apply each time you begin working with a new InSAR velocity dataset. Please see the linked tutorial for details on the data, applications, and each step in this process."
+    "Here we wrap the reorganization of InSAR ice velocity data illustrated in [this tutorial](https://tutorial.xarray.dev/intermediate/data_cleaning/05.3_ice_velocity.html) into a custom Xarray extension that makes it easy to re-apply each time you begin working with a new InSAR velocity dataset. Please see the linked tutorial for details on the data, applications, and each step in this process."
    ]
   },
   {
@@ -425,5 +425,5 @@
   }
  },
  "nbformat": 4,
- "nbformat_minor": 2
+ "nbformat_minor": 4
 }
diff --git a/advanced/map_blocks/simple_map_blocks.ipynb b/advanced/map_blocks/simple_map_blocks.ipynb
@@ -7,9 +7,6 @@
     "tags": []
    },
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
-    "\n",
     "# A gentle introduction\n",
     "\n",
     "`map_blocks` is inspired by the `dask.array` function of the same name and lets\n",
diff --git a/fundamentals/01.1_creating_data_structures.ipynb b/fundamentals/01.1_creating_data_structures.ipynb
@@ -5,8 +5,6 @@
    "id": "0",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Creating Data Structures"
    ]
   },
diff --git a/fundamentals/01_datastructures.ipynb b/fundamentals/01_datastructures.ipynb
@@ -4,8 +4,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Xarray's Data structures\n",
     "\n",
     "In this lesson, we cover the basics of Xarray data structures. Our\n",
diff --git a/fundamentals/02.2_manipulating_dimensions.ipynb b/fundamentals/02.2_manipulating_dimensions.ipynb
@@ -4,8 +4,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Manipulating Dimensions (Data Resolution)\n",
     "\n",
     "Sometimes we need to change the resolution of our data. We might need to look at inferred values between dimension (grid) spaces\n",
diff --git a/fundamentals/02.3_aligning_data_objects.ipynb b/fundamentals/02.3_aligning_data_objects.ipynb
@@ -4,8 +4,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Computing with Multiple Objects\n",
     "\n",
     "Learning goals:\n",
diff --git a/fundamentals/03.4_weighted.ipynb b/fundamentals/03.4_weighted.ipynb
@@ -7,9 +7,6 @@
     "tags": []
    },
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
-    "\n",
     "# Weighted Reductions\n",
     "\n",
     "Xarray supports [weighted reductions](https://docs.xarray.dev/en/stable/user-guide/computation.html#weighted-array-reductions).\n",
diff --git a/fundamentals/04.1_basic_plotting.ipynb b/fundamentals/04.1_basic_plotting.ipynb
@@ -6,8 +6,6 @@
     "toc": true
    },
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Basic Visualization\n",
     "\n",
     "At the end of this lesson you will learn:\n",
diff --git a/fundamentals/04.2_faceting.ipynb b/fundamentals/04.2_faceting.ipynb
@@ -5,8 +5,6 @@
    "id": "0",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Faceting\n",
     "\n",
     "Faceting is the art of presenting \"small multiples\" of the data. It is an\n",
diff --git a/fundamentals/04.3_geographic_plotting.ipynb b/fundamentals/04.3_geographic_plotting.ipynb
@@ -5,8 +5,6 @@
    "id": "0",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Geography with Cartopy\n",
     "\n",
     "Since xarray's default plotting functionality builds on matplotlib, we can\n",
diff --git a/fundamentals/05_intro_to_dask.ipynb b/fundamentals/05_intro_to_dask.ipynb
@@ -4,8 +4,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Introduction to Dask\n",
     "\n",
     "In this lesson, we discuss cover the basics of Dask. Our learning goals are as\n",
diff --git a/intermediate/hvplot.ipynb b/intermediate/hvplot.ipynb
@@ -5,9 +5,6 @@
    "id": "0",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
-    "\n",
     "# Interactive plots using hvplot\n",
     "\n",
     "Xarray's builtin plotting functionality wraps matplotlib.\n",
diff --git a/intermediate/xarray_and_dask.ipynb b/intermediate/xarray_and_dask.ipynb
@@ -4,8 +4,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# Parallel computing with Dask\n",
     "\n",
     "This notebook demonstrates one of Xarray's most powerful features: the ability\n",
diff --git a/intermediate/xarray_ecosystem.ipynb b/intermediate/xarray_ecosystem.ipynb
@@ -5,8 +5,6 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",
-    "\n",
     "# A Tour of Xarray Customizations\n",
     "\n",
     "Xarray is easily extensible.\n",
@@ -510,7 +508,9 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Note: It is preferred to use `.pint.quantify()` to convert xarray data to use pint rather than explicitly creating a `pint.Quantity` array and placing it inside the xarray object, because pint-xarray will handle various subtleties involving dask etc."
+    "```{note}\n",
+    "It is preferred to use `.pint.quantify()` to convert xarray data to use pint rather than explicitly creating a `pint.Quantity` array and placing it inside the xarray object, because pint-xarray will handle various subtleties involving dask etc.\n",
+    "```"
    ]
   },
   {
@@ -609,34 +609,39 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "**Exercise:** Write a function which will raise an error if supplied with data in the wrong units."
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
+    "```{exercise}\n",
+    ":label: wrong-unit\n",
+    "Write a function which will raise a `pint.DimensionalityError` if supplied with Xarray DataArray with the wrong units.\n",
+    "```\n",
+    "\n",
+    "````{solution} wrong-unit\n",
+    ":class: dropdown\n",
+    "\n",
+    "```python\n",
     "from pint import DimensionalityError\n",
     "\n",
     "\n",
     "def special_science_function(distance):\n",
     "    if distance.pint.units != \"miles\":\n",
     "        raise DimensionalityError(\n",
     "            \"this function will only give the correct answer if the input is in units of miles\"\n",
-    "        )"
+    "        )\n",
+    "```\n",
+    "\n",
+    "````"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "**Exercise:** Try this on some of your data!\n",
+    "```{exercise}\n",
+    "Try this on some of your data!\n",
     "\n",
     "After you have imported pint-xarray (and maybe cf-xarray) as above, start with something like\n",
     "\n",
-    "`ds = xr.open_dataset(my_data).pint.quantify()`"
+    "`ds = xr.open_dataset(my_data).pint.quantify()`\n",
+    "```"
    ]
   },
   {
@@ -659,13 +664,6 @@
    "source": [
     "There are many other libraries in the wider xarray ecosystem. For a list of a few packages we particularly like for geoscience work [see here](https://tutorial.xarray.dev/overview/xarray-in-45-min.html#other-cool-packages), and for a [more exhaustive list see here](https://docs.xarray.dev/en/stable/ecosystem.html)."
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
diff --git a/overview/get-started.md b/overview/get-started.md
@@ -1,4 +1,4 @@
-<img src="https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png" align="right" width="30%">
+<img src="https://docs.xarray.dev/en/stable/_static/Xarray_Logo_RGB_Final.svg" align="right" width="30%">
 
 (get-started)=
 
diff --git a/overview/xarray-in-45-min.ipynb b/overview/xarray-in-45-min.ipynb

Original file line number	Diff line number	Diff line change
`@@ -117,7 +117,7 @@`
`117`	`117`	`"\n",`
`118`	`118`	`"Perhaps you find yourself running similar code for multiple xarray objects or across related projects. By packing your code into an extension, it makes it easy to repeat the same operation while reducing the likelihood of [human introduced] errors.\n",`
`119`	`119`	`"\n",`
`120`		`- "Here we wrap the reorganization of InSAR ice velocity data illustrated in [this tutorial](https://tutorial.xarray.dev/data_cleaning/ice_velocity.html?highlight=ice_velocity) into a custom Xarray extension that makes it easy to re-apply each time you begin working with a new InSAR velocity dataset. Please see the linked tutorial for details on the data, applications, and each step in this process."`
	`120`	`+ "Here we wrap the reorganization of InSAR ice velocity data illustrated in [this tutorial](https://tutorial.xarray.dev/intermediate/data_cleaning/05.3_ice_velocity.html) into a custom Xarray extension that makes it easy to re-apply each time you begin working with a new InSAR velocity dataset. Please see the linked tutorial for details on the data, applications, and each step in this process."`
`121`	`121`	`]`
`122`	`122`	`},`
`123`	`123`	`{`
`@@ -425,5 +425,5 @@`
`425`	`425`	`}`
`426`	`426`	`},`
`427`	`427`	`"nbformat": 4,`
`428`		`- "nbformat_minor": 2`
	`428`	`+ "nbformat_minor": 4`
`429`	`429`	`}`
Original file line number	Diff line number	Diff line change
`@@ -5,8 +5,6 @@`
`5`	`5`	`"id": "0",`
`6`	`6`	`"metadata": {},`
`7`	`7`	`"source": [`
`8`		`- "<img src=\"https://docs.xarray.dev/en/stable/_static/dataset-diagram-logo.png\" align=\"right\" width=\"30%\">\n",`
`9`		`- "\n",`
`10`	`8`	`"# Creating Data Structures"`
`11`	`9`	`]`
`12`	`10`	`},`