@mapequation/d3gl

GPU-accelerated rendering for d3 — especially maps with GeoJSON and grid-cell data, and large node–link networks — with switchable SVG / Canvas2D / WebGL2 backends.

d3's generators (d3-geo's geoPath, d3-shape, d3-hierarchy links) don't draw; they emit path commands to a context. d3gl implements that same context across SVG / Canvas2D / WebGL2, so any context-driven d3 generator can render on the GPU unchanged. Geometry is projected & tessellated once; pan/zoom is one transform-matrix uniform and recolor/show-hide is one texture write.

Install

npm i @mapequation/d3gl
# React components also need:  npm i react react-dom   (optional peer deps)

Subpath exports

import { Scene } from "@mapequation/d3gl";            // core (root entry)
import { geoMap, plot } from "@mapequation/d3gl/map"; // interactive engines
import { network } from "@mapequation/d3gl/network";   // large-network engine
import { fitProjection } from "@mapequation/d3gl/geo"; // project-once primitives
import { D3GL } from "@mapequation/d3gl/react";        // React component
// also: /webgl  /canvas  /svg  /labels

| Subpath | Responsibility | | --- | --- | | (root) | Scene, PathContext, tessellation, stroke expansion, hit-testing | | /canvas | Canvas2D backend | | /webgl | luma.gl v9 WebGL2 backend (palette-texture color, GPU picking, PNG export) | | /svg | SVG backend + vector export | | /geo | projection + GeoJSON project-once helpers, inverse projection | | /labels | HTML label overlay with culling | | /map | geoMap + plot engines with d3-zoom wiring | | /network | network engine for large node–link graphs: force layout (worker/GPU), level-of-detail, maps of networks | | /react | headless MapController + <D3GL> component |

Full docs, the API reference and live examples: https://mapequation.github.io/d3gl/. Source and issues: the repository.

License

MIT © Daniel Edler