Integrate

Choose the interface that fits your application.

Interface	Use it for	Guide
Python and xarray	Read and analyze stores, reconstruct temporal encoding, access physical values.	Python
JavaScript reader	Fetch decoded cells without a DOM or renderer.	Reader
MapLibre layer	Add a store to an existing map.	MapLibre
chronozarr iframe	Embed a ready-made viewer with playback and inspection.	Embedding
COG export and STAC	Share reconstructed values and catalog metadata with other tools.	CLI

Python

import chronozarr
 
store = chronozarr.open_store("my_store")
values = store.read(t=0)

For a local notebook viewer, install chronozarr[notebook] and call chronozarr.view("my_store"). It starts a local range-capable server for local stores.

JavaScript

npm install chronozarr

import { openStore } from 'chronozarr'
 
const store = await openStore('https://data.tileripper.com/ucayali_santa_maria/chronozarr-4')
const lod = store.levels.length - 1
const cell = await store.getCell(lod, 0, 0, 0)
console.log(cell.data)
store.close()

The returned typed array contains reconstructed stored values. Scale and offset are applied separately when you want physical units.

Embed a viewer

<iframe
  title="Raster time series viewer"
  src="https://chronozarr.org/demo/?embed=1"
  width="100%"
  height="600"
  loading="lazy"
></iframe>

The embedding guide covers store URLs, controls, themes, and the postMessage contract for host applications.