feat(styling)!: grouped render parameters + a large vendored preset-library expansion

.gitignore

@@ -141,3 +141,4 @@ CLAUDE.md
 # Local-only maintainer colour-map download scripts (kept out of git)
 tools/build_scientific_presets.py
 tools/build_terrain_presets.py
+tools/build_weather_presets.py

README.md

@@ -93,7 +93,7 @@ graph TD
 - Display cell values and overlay point markers on the plot.
 - Animate 3D single-band stacks or 4D RGB/RGBA true-colour stacks over time, and export to GIF, WebP, MP4, MOV, or
   AVI (bundled ffmpeg -- no separate install needed).
-- Drop in an ECMWF/CAMS-style basemap (coastlines, borders, graticule) with a single `add_reference_map` call.
+- Drop in a CAMS-style basemap (coastlines, borders, graticule) with a single `add_reference_map` call.
 
 <p align="center">
   <img src="docs/images/array_glyph/array-plot.png" width="45%" alt="Array Plot" />
@@ -177,7 +177,7 @@ graph TD
 - `ArrayGlyph`, `MeshGlyph`, `ScatterGlyph`, `VectorGlyph`, `FlowGlyph`, and `PolygonGlyph` mix in `GeoMixin`, adding a
   settable `crs` plus one-call basemap helpers on `glyph.ax`: `add_tiles` (XYZ web-tile mosaics), `add_features` /
   `add_relief` (Natural Earth coastlines, borders, land, ocean, rivers, lakes, and a hypsometric relief backdrop), a
-  one-call `add_reference_map` preset (`"ecmwf"`, `"ecmwf-dark"`, or `"auto"`), and `add_labels` for city/point labels.
+  one-call `add_reference_map` preset (`"light"`, `"dark"`, or `"auto"`), and `add_labels` for city/point labels.
 - `tiles` and the fixed-public-dataset `reference` layers require the `cleopatra[tiles]` extra.
 
 <p align="center">
@@ -190,7 +190,7 @@ graph TD
   organic-matter / dust look) -- per-pixel opacity tied to value via `alpha_scaled_image` / `alpha_scaled_mesh`, plus a
   swatch legend, in one call.
 - `projection.apply_projection_style` reprojects `(lon, lat, data)` onto an orthographic "globe" view (or leaves it
-  flat) via named presets, pairing with `apply_data_style` to build ECMWF/CAMS-style globe animations in a few lines.
+  flat) via named presets, pairing with `apply_data_style` to build CAMS-style globe animations in a few lines.
   The orthographic helpers require the `cleopatra[tiles]` extra (`pyproj`).
 
 ### Colors -- Color Utilities
@@ -301,7 +301,7 @@ from cleopatra.glyphs.gridded.array_glyph import ArrayGlyph
 field = np.random.rand(80, 120)
 glyph = ArrayGlyph(field, extent=[-100, 15, -40, 55])  # west, south, east, north
 glyph.plot(cmap="turbo", cbar_label="anomaly")
-glyph.add_reference_map("ecmwf")  # coastlines, borders, and a lon/lat graticule
+glyph.add_reference_map("light")  # coastlines, borders, and a lon/lat graticule
 ```
 
 ## Requirements

docs/index.md

@@ -99,7 +99,7 @@ graph TD
   `data_getter` for streaming frames) and export to GIF / WebP / MP4 / MOV / AVI (bundled ffmpeg, no separate
   install).
 - Overlay point markers and per-cell value labels.
-- Drop in an ECMWF/CAMS-style basemap (coastlines, borders, graticule) with a single `add_reference_map` call.
+- Drop in a CAMS-style basemap (coastlines, borders, graticule) with a single `add_reference_map` call.
 
 See the [ArrayGlyph reference](reference/array-glyph.md).
 
@@ -160,7 +160,7 @@ See the [KDEGlyph reference](reference/kde-glyph.md).
 - `ArrayGlyph`, `MeshGlyph`, `ScatterGlyph`, `VectorGlyph`, `FlowGlyph`, and `PolygonGlyph` mix in `GeoMixin`,
   adding a settable `crs` plus one-call basemap helpers on `glyph.ax`: `add_tiles` (XYZ web-tile mosaics),
   `add_features` / `add_relief` (Natural Earth coastlines, borders, land, ocean, rivers, lakes, and a hypsometric
-  relief backdrop), a one-call `add_reference_map` preset (`"ecmwf"`, `"ecmwf-dark"`, or `"auto"`), and
+  relief backdrop), a one-call `add_reference_map` preset (`"light"`, `"dark"`, or `"auto"`), and
   `add_labels` for city/point labels.
 
 See the [Geo basemap methods reference](reference/geo.md), [Tiles reference](reference/tiles.md), and
@@ -182,7 +182,7 @@ See the [Tiles reference](reference/tiles.md) and [Reference data reference](ref
   organic-matter / dust look) — per-pixel opacity tied to value via `alpha_scaled_image` / `alpha_scaled_mesh`,
   plus a swatch legend, in one call.
 - `projection.apply_projection_style` reprojects `(lon, lat, data)` onto an orthographic "globe" view (or leaves it
-  flat) via named presets, pairing with `apply_data_style` to build ECMWF/CAMS-style globe animations in a few
+  flat) via named presets, pairing with `apply_data_style` to build CAMS-style globe animations in a few
   lines. The orthographic helpers need the `cleopatra[tiles]` extra (`pyproj`).
 
 See the [Haze-style presets example](notebooks/haze_preset/haze_preset_examples.ipynb) and the

docs/notebooks/presets/cams_aerosols_and_particulates.ipynb

@@ -24,14 +24,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "f34615e5",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:52:57.106560Z",
-     "iopub.status.busy": "2026-08-09T20:52:57.106560Z",
-     "iopub.status.idle": "2026-08-09T20:52:57.663084Z",
-     "shell.execute_reply": "2026-08-09T20:52:57.661995Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "import numpy as np\n",
@@ -92,14 +85,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "0b27b848",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:52:57.666902Z",
-     "iopub.status.busy": "2026-08-09T20:52:57.666114Z",
-     "iopub.status.idle": "2026-08-09T20:52:58.100868Z",
-     "shell.execute_reply": "2026-08-09T20:52:58.100868Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "gallery(['aerosol_optical_depth_550nm', 'dust_aerosol_optical_depth_550nm', 'sulphate_aerosol_optical_depth_550nm', 'particulate_matter_10um', 'particulate_matter_2p5um'])"
@@ -119,14 +105,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "114ed593",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:52:58.102877Z",
-     "iopub.status.busy": "2026-08-09T20:52:58.102877Z",
-     "iopub.status.idle": "2026-08-09T20:52:58.205693Z",
-     "shell.execute_reply": "2026-08-09T20:52:58.205146Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "name = \"aerosol_optical_depth_550nm\"\n",

docs/notebooks/presets/cams_greenhouse_gases.ipynb

@@ -24,14 +24,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "6b00b6a9",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:04.029686Z",
-     "iopub.status.busy": "2026-08-09T20:53:04.028685Z",
-     "iopub.status.idle": "2026-08-09T20:53:04.582370Z",
-     "shell.execute_reply": "2026-08-09T20:53:04.582370Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "import numpy as np\n",
@@ -92,14 +85,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "813e5195",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:04.585392Z",
-     "iopub.status.busy": "2026-08-09T20:53:04.584881Z",
-     "iopub.status.idle": "2026-08-09T20:53:05.108315Z",
-     "shell.execute_reply": "2026-08-09T20:53:05.108315Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "gallery(['co2_column_mean_molar_fraction', 'ch4_column_mean_molar_fraction', 'methane_surface', 'methane_850hpa', 'methane_500hpa', 'methane_300hpa', 'methane_50hpa', 'carbon_monoxide_700hpa', 'carbon_monoxide_500hpa'])"
@@ -119,14 +105,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "88113048",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:05.115408Z",
-     "iopub.status.busy": "2026-08-09T20:53:05.115408Z",
-     "iopub.status.idle": "2026-08-09T20:53:05.221963Z",
-     "shell.execute_reply": "2026-08-09T20:53:05.221963Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "name = \"ch4_column_mean_molar_fraction\"\n",

docs/notebooks/presets/cams_reactive_gases.ipynb

@@ -24,14 +24,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "67b67bc8",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:00.566219Z",
-     "iopub.status.busy": "2026-08-09T20:53:00.566219Z",
-     "iopub.status.idle": "2026-08-09T20:53:01.103368Z",
-     "shell.execute_reply": "2026-08-09T20:53:01.103368Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "import numpy as np\n",
@@ -92,14 +85,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "29330565",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:01.106500Z",
-     "iopub.status.busy": "2026-08-09T20:53:01.105461Z",
-     "iopub.status.idle": "2026-08-09T20:53:01.430960Z",
-     "shell.execute_reply": "2026-08-09T20:53:01.430960Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "gallery(['ozone', 'nitrogen_dioxide', 'total_column_ozone', 'total_column_carbon_monoxide', 'total_column_sulphur_dioxide'])"
@@ -119,14 +105,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "a0466d24",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:01.435481Z",
-     "iopub.status.busy": "2026-08-09T20:53:01.434474Z",
-     "iopub.status.idle": "2026-08-09T20:53:01.544555Z",
-     "shell.execute_reply": "2026-08-09T20:53:01.544555Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "name = \"total_column_ozone\"\n",

docs/notebooks/presets/cams_uv_and_fire.ipynb

@@ -24,14 +24,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "717b676d",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:08.208169Z",
-     "iopub.status.busy": "2026-08-09T20:53:08.208169Z",
-     "iopub.status.idle": "2026-08-09T20:53:08.982302Z",
-     "shell.execute_reply": "2026-08-09T20:53:08.981293Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "import numpy as np\n",
@@ -92,14 +85,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "6e4e94bf",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:08.986339Z",
-     "iopub.status.busy": "2026-08-09T20:53:08.985330Z",
-     "iopub.status.idle": "2026-08-09T20:53:09.227493Z",
-     "shell.execute_reply": "2026-08-09T20:53:09.227493Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "gallery(['uv_index', 'uv_index_clear_sky', 'wildfire_radiative_power'])"
@@ -119,14 +105,7 @@
    "cell_type": "code",
    "execution_count": null,
    "id": "4b4acc18",
-   "metadata": {
-    "execution": {
-     "iopub.execute_input": "2026-08-09T20:53:09.230499Z",
-     "iopub.status.busy": "2026-08-09T20:53:09.230499Z",
-     "iopub.status.idle": "2026-08-09T20:53:09.329508Z",
-     "shell.execute_reply": "2026-08-09T20:53:09.329508Z"
-    }
-   },
+   "metadata": {},
    "outputs": [],
    "source": [
     "name = \"uv_index\"\n",