zarr-maps-ol

OpenLayers tile-layer integration for rendering multidimensional Zarr and Icechunk datasets directly in the browser.

npm install zarr-maps-ol ol

import Map from 'ol/Map';
import { ZarrLayer } from 'zarr-maps-ol';

const layer = new ZarrLayer({
  id: 'temperature',
  url: 'https://example.com/temperature.zarr',
  variable: 'temperature',
  colormap: 'viridis',
  scale: [270, 310]
});

await layer.load();
map.addLayer(layer);

Regular rectilinear grids may use any source CRS understood by proj4. The source CRS is independent of the OpenLayers view projection:

const polarLayer = new ZarrLayer({
  id: 'sea-ice-age',
  url: 'https://example.com/sea-ice-age.zarr',
  variable: 'age_of_sea_ice',
  crs: 'EPSG:3408',
  proj4: '+proj=laea +lat_0=90 +lon_0=0 +x_0=0 +y_0=0 +a=6371228 +b=6371228 +units=m +no_defs',
  dimensionNames: { lon: 'x', lat: 'y', time: 'time' },
  selectors: { time: { selected: 0, type: 'index' } },
  scale: [0, 5]
});

Curvilinear grids with two-dimensional latitude or longitude coordinate arrays are not currently supported.

The layer supports custom Zarrita stores such as Icechunk, authenticated requests, dimension selectors, runtime styling, and point/profile/transect queries. See the zarr-maps documentation for complete configuration and API details.

Classes

Class	Description
ZarrLayer	OpenLayers Zarr tile layer using the shared ZarrTileProvider.

Interfaces

Interface	Description
OLLayerOptions	Configuration for a 2D raster (image) layer visualization in OpenLayers. The inherited `crs` and `proj4` options describe the rectilinear Zarr source grid, independently of the OpenLayers view projection.
ZarrImageElement	-

Classes​

Interfaces​

Classes

Interfaces