feat: initial skeleton noaa hrrr notebook

Author: gadomski

datasets/noaa-hrrr/noaa-hrrr-example.ipynb

@@ -0,0 +1,77 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "id": "01687b54",
+   "metadata": {},
+   "source": [
+    "## Accessing NOAA HRRR data with the Planetary Computer STAC API\n",
+    "\n",
+    "The [NOAA High-Resolution Rapid Refresh (HRRR)](https://rapidrefresh.noaa.gov/hrrr/) is a real-time 3-km resolution, hourly updated, cloud-resolving, convection-allowing atmospheric model, initialized by 3km grids with 3km radar assimilation.\n",
+    "Radar data is assimilated in the HRRR every 15 min over a 1-h period adding further detail to that provided by the hourly data assimilation from the 13km radar-enhanced Rapid Refresh . \n",
+    "\n",
+    "This notebook demonstrates use of the Planetary Computer STAC API to query for NOAA HRRR data."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "38a3b9f0",
+   "metadata": {},
+   "source": [
+    "### Environment setup\n",
+    "\n",
+    "We import all classes, modules, and function at the top to be explicit about what packages you'll need."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "de8f1804",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from pystac_client import Client\n",
+    "import planetary_computer"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "b447c2b2",
+   "metadata": {},
+   "source": [
+    "### Data access\n",
+    "\n",
+    "The datasets hosted by the Planetary Computer are available from [Azure Blob Storage](https://docs.microsoft.com/en-us/azure/storage/blobs/).\n",
+    "We'll use [pystac-client](https://pystac-client.readthedocs.io/) to search the Planetary Computer's [STAC API](https://planetarycomputer.microsoft.com/api/stac/v1/docs) for data in our date and time of interest, and then we'll load the data directly from Azure Blob Storage.\n",
+    "We'll specify a `modifier` so that we can access the data stored in the Planetary Computer's private Blob Storage Containers.\n",
+    "See [Reading from the STAC API](https://planetarycomputer.microsoft.com/docs/quickstarts/reading-stac/) and [Using tokens for data access](https://planetarycomputer.microsoft.com/docs/concepts/sas/) for more."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f3cfb7a9",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "client = Client.open(\n",
+    "    \"https://planetarycomputer.microsoft.com/api/stac/v1\",\n",
+    "    modifier=planetary_computer.sign_inplace,\n",
+    ")"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "PlanetaryComputerExamples",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.13.2"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}