From b908ea6864ca86d55c395a5f01b655025fb44033 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 10 Jan 2026 03:54:16 +0000 Subject: [PATCH] spec: add scatter-map-geographic specification Created from issue #3617 --- plots/scatter-map-geographic/specification.md | 31 +++++++++++++++++++ .../scatter-map-geographic/specification.yaml | 29 +++++++++++++++++ 2 files changed, 60 insertions(+) create mode 100644 plots/scatter-map-geographic/specification.md create mode 100644 plots/scatter-map-geographic/specification.yaml diff --git a/plots/scatter-map-geographic/specification.md b/plots/scatter-map-geographic/specification.md new file mode 100644 index 0000000000..2fbf03a241 --- /dev/null +++ b/plots/scatter-map-geographic/specification.md @@ -0,0 +1,31 @@ +# scatter-map-geographic: Scatter Map with Geographic Points + +## Description + +A geographic scatter plot that displays data points on a world or regional map, with each point positioned by its latitude and longitude coordinates. This visualization is ideal for showing spatial distributions of events, locations, or measurements across geographic areas. Points can optionally encode additional variables through size and color, enabling multi-dimensional geographic analysis at a glance. + +## Applications + +- Visualizing earthquake epicenters or natural disaster locations with magnitude encoded as point size +- Mapping customer or store locations with sales volume represented by point size and category by color +- Displaying sensor network readings across a geographic region with measurement values encoded in color +- Tracking wildlife sightings or species distribution with population counts as point size + +## Data + +- `latitude` (numeric) - Geographic latitude coordinate (-90 to 90) +- `longitude` (numeric) - Geographic longitude coordinate (-180 to 180) +- `value` (numeric, optional) - Variable for color encoding (e.g., measurement, category code) +- `size` (numeric, optional) - Variable for point size encoding (e.g., magnitude, count) +- `label` (string, optional) - Point label or identifier for tooltips +- Size: 20-500 points (works well with moderate density; too many points may require clustering) +- Example: City locations with population and region, earthquake data with magnitude and depth + +## Notes + +- Use an appropriate map projection (e.g., Natural Earth, Robinson for world maps; Mercator for regional/city scale) +- Include a basemap showing country boundaries, coastlines, or terrain for geographic context +- Add a color legend when color encoding is used, and a size legend when size varies +- Consider using transparency (alpha) to handle overlapping points in dense regions +- For interactive libraries, enable zoom and pan to explore point clusters +- Ensure point colors have sufficient contrast against the basemap diff --git a/plots/scatter-map-geographic/specification.yaml b/plots/scatter-map-geographic/specification.yaml new file mode 100644 index 0000000000..a41d7243ff --- /dev/null +++ b/plots/scatter-map-geographic/specification.yaml @@ -0,0 +1,29 @@ +# Specification-level metadata for scatter-map-geographic +# Auto-synced to PostgreSQL on push to main + +spec_id: scatter-map-geographic +title: Scatter Map with Geographic Points + +# Specification tracking +created: 2026-01-10T03:53:51Z +updated: null +issue: 3617 +suggested: MarkusNeusinger + +# Classification tags (applies to all library implementations) +# See docs/reference/tagging-system.md for detailed guidelines +tags: + plot_type: + - scatter + - map + data_type: + - geospatial + - numeric + domain: + - general + - science + - business + features: + - basic + - color-mapped + - proportional