expanded voter data

open_meteo_historical_data_centers.ipynb

@@ -836,6 +836,30 @@
     "\n",
     "**Metric change vs. the prior Open-Meteo implementation.** The old `windstorm_days` field counted days where the daily *max wind gust* exceeded 17.2 m/s (~38 mph, ERA5 reanalysis gust). gridMET reports only daily *mean* wind, not gusts, so the new `sustained_wind_days` field counts days with daily-mean wind ≥ 8 m/s (~18 mph). These are fundamentally different signals — do not compare values across the two columns. If true gust/storm event counts are needed, NOAA's Storm Events Database is the appropriate next source.\n"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "18",
+   "metadata": {},
+   "source": [
+    "## Tables Created by This Notebook and Their Relationships\n",
+    "\n",
+    "This notebook creates and/or maintains one primary PostGIS table:\n",
+    "\n",
+    "1. `public.data_center_historical_climate`\n",
+    "- One row per data center (`master_id`).\n",
+    "- Stores climate summary metrics (temperature, humidity, wet-bulb, precipitation variability, cooling-degree-days, wind fields/status), geometry, and lineage timestamps.\n",
+    "- Upserted incrementally so reruns refresh changed rows without duplicating records.\n",
+    "\n",
+    "### Relationship Summary\n",
+    "\n",
+    "- `public.master_data_centers (master_id)`\n",
+    "  - 1-to-1 (effective) -> `public.data_center_historical_climate (master_id)`\n",
+    "\n",
+    "`public.data_center_historical_climate.master_id` is a foreign key to `public.master_data_centers.master_id` (with cascade delete), so climate rows track the master data-center record set.\n",
+    "\n",
+    "In short: **`master_data_centers` is the entity table, and `data_center_historical_climate` is its one-row-per-site climate feature extension.**"
+   ]
   }
  ],
  "metadata": {