add more info for running in Colab

Author: eeholmes

README.md

@@ -15,3 +15,7 @@ Examples are included for PACE, TEMPO, ICESat-2 ATL21, ECCO and MUR.
 ## PyPI
 
 <https://pypi.org/project/point-collocation/>
+
+## Data Regions
+
+This package currently is designed to do point matchups against NASA EarthData. In a virtual machine in AWS us-west-2, where NASA cloud data is, the point matchups are fast. In Colab, say, your comppute is not in the same data region nor provider (Google versus AWS), and the same matchups might take 10x longer. Thus if you have big matchup tasks, 10s of thousands of points, it is wise to do that in AWS us-west-2.

examples/docs_1_pace_l3.ipynb

@@ -14,6 +14,8 @@
     "* Print the plan to check it `print(plan.summary())`\n",
     "* Do the plan and get matchups `pc.matchup(plan)`\n",
     "\n",
+    "*Note*: In a virtual machine in AWS us-west-2, where NASA cloud data is, the point matchups are fast. In Colab, say, your comppute is not in the same data region nor provider (Google versus AWS), and the same matchups might take 10x longer. Thus if you have big matchup tasks, 10s of thousands of points, it is wise to do that in AWS us-west-2.\n",
+    "\n",
     "## Read in some points"
    ]
   },
@@ -86,6 +88,48 @@
     "df"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "037fb7d4-404a-4b47-89b3-1d4ebc915208",
+   "metadata": {},
+   "source": [
+    "## Prerequisites"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "daf8b793-9495-40e0-9e7f-c9ee6445508c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# install if needed\n",
+    "pip install point-collocation --quiet"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "id": "051ddcae-f267-48f1-83cc-97c3947eb137",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "<earthaccess.auth.Auth at 0x7f4675d2bd10>"
+      ]
+     },
+     "execution_count": 1,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "# Make sure you are logged in\n",
+    "import earthaccess\n",
+    "earthaccess.login()"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "c5b68c9a-8fd4-4c10-b554-11f1ba1edbfe",
@@ -1570,7 +1614,9 @@
    "id": "49389bf6-adac-44cb-835e-9200951e7eaa",
    "metadata": {},
    "source": [
-    "## Get 100 matchups using that plan"
+    "## Get 100 matchups using that plan\n",
+    "\n",
+    "In a virtual machine in AWS us-west-2, where NASA cloud data is, this is 12 seconds. In Colab, say, this might be over a minute since you are not in the same data region nor provider (Google versus AWS).\n"
    ]
   },
   {