Update documentation

Author: spatialthoughts

_sources/notebooks/xarray_extracting_time_series_multiple.ipynb

@@ -45,7 +45,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "id": "6058b268-9e94-416c-9698-4888111c9b10",
    "metadata": {
     "id": "6058b268-9e94-416c-9698-4888111c9b10"
@@ -54,7 +54,7 @@
    "source": [
     "%%capture\n",
     "if 'google.colab' in str(get_ipython()):\n",
-    "    !pip install rioxarray"
+    "    !pip install rioxarray dask[distributed]"
    ]
   },
   {
@@ -79,6 +79,48 @@
     "import zipfile"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "81bb22c2",
+   "metadata": {},
+   "source": [
+    "Setup a local Dask cluster. This distributes the computation across multiple workers on your computer."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "c7a705ac",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from dask.distributed import Client\n",
+    "client = Client()  # set up local cluster on the machine\n",
+    "client"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8bc0a693",
+   "metadata": {},
+   "source": [
+    "If you are running this notebook in Colab, you will need to create and use a proxy URL to see the dashboard running on the local server.\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "3733a3ec",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "if 'google.colab' in str(get_ipython()):\n",
+    "    from google.colab import output\n",
+    "    port_to_expose = 8787  # This is the default port for Dask dashboard\n",
+    "    print(output.eval_js(f'google.colab.kernel.proxyPort({port_to_expose})'))"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 3,

notebooks/xarray_extracting_time_series_multiple.html

@@ -506,7 +506,7 @@ <h2>Setup and Data Download<a class="headerlink" href="#setup-and-data-download"
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="o">%%capture</span>
 <span class="k">if</span> <span class="s1">&#39;google.colab&#39;</span> <span class="ow">in</span> <span class="nb">str</span><span class="p">(</span><span class="n">get_ipython</span><span class="p">()):</span>
-    <span class="err">!</span><span class="n">pip</span> <span class="n">install</span> <span class="n">rioxarray</span>
+    <span class="err">!</span><span class="n">pip</span> <span class="n">install</span> <span class="n">rioxarray</span> <span class="n">dask</span><span class="p">[</span><span class="n">distributed</span><span class="p">]</span>
 </pre></div>
 </div>
 </div>
@@ -528,6 +528,27 @@ <h2>Setup and Data Download<a class="headerlink" href="#setup-and-data-download"
 </div>
 </div>
 </div>
+<p>Setup a local Dask cluster. This distributes the computation across multiple workers on your computer.</p>
+<div class="cell docutils container">
+<div class="cell_input docutils container">
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="kn">from</span><span class="w"> </span><span class="nn">dask.distributed</span><span class="w"> </span><span class="kn">import</span> <span class="n">Client</span>
+<span class="n">client</span> <span class="o">=</span> <span class="n">Client</span><span class="p">()</span>  <span class="c1"># set up local cluster on the machine</span>
+<span class="n">client</span>
+</pre></div>
+</div>
+</div>
+</div>
+<p>If you are running this notebook in Colab, you will need to create and use a proxy URL to see the dashboard running on the local server.</p>
+<div class="cell docutils container">
+<div class="cell_input docutils container">
+<div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="k">if</span> <span class="s1">&#39;google.colab&#39;</span> <span class="ow">in</span> <span class="nb">str</span><span class="p">(</span><span class="n">get_ipython</span><span class="p">()):</span>
+    <span class="kn">from</span><span class="w"> </span><span class="nn">google.colab</span><span class="w"> </span><span class="kn">import</span> <span class="n">output</span>
+    <span class="n">port_to_expose</span> <span class="o">=</span> <span class="mi">8787</span>  <span class="c1"># This is the default port for Dask dashboard</span>
+    <span class="nb">print</span><span class="p">(</span><span class="n">output</span><span class="o">.</span><span class="n">eval_js</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;google.colab.kernel.proxyPort(</span><span class="si">{</span><span class="n">port_to_expose</span><span class="si">}</span><span class="s1">)&#39;</span><span class="p">))</span>
+</pre></div>
+</div>
+</div>
+</div>
 <div class="cell docutils container">
 <div class="cell_input docutils container">
 <div class="highlight-ipython3 notranslate"><div class="highlight"><pre><span></span><span class="n">data_folder</span> <span class="o">=</span> <span class="s1">&#39;data&#39;</span>