Getting Started
zarrita supports a variety of environments, including the browser, Node.js, and Deno.
Try Zarr online
You can try out zarrita on Observable! Fork the example notebook and try loading some of your own data.
Zarr in vanilla HTML
In vanilla HTML, you can load zarrita from a CDN such as jsDelivr or esm.sh or you can download it locally. We recommend using the CDN-hosted ES module bundle since it automatically loads the other dependencies.
html
<!DOCTYPE html>
<script type="module">
import * as zarr from "https://cdn.jsdelivr.net/npm/zarrita@next/+esm";
const store = new zarr.FetchStore("https://raw.githubusercontent.com/zarr-developers/zarr_implementations/5dc998ac72/examples/zarr.zr/blosc");
const arr = await zarr.open(store, { kind: "array" });
// {
// store: FetchStore,
// path: "/",
// dtype: "uint8",
// shape: [512, 512, 3],
// chunks: [100, 100, 1],
// }
const view = await zarr.get(arr, [null, null, 0]);
// {
// data: Uint8Array,
// shape: [512, 512],
// stride: [512, 1],
// }
</script>
Installing from npm
If you're developing an application with Node.js, you can install zarrita via yarn, npm, pnpm:
sh
npm install zarrita@next
You can then load zarrita modules into your app as:
javascript
import * as zarr from "zarrita";
const arr = await zarr.open(store);
or instead, import specific exports:
javascript
import { open } from "zarrita";
const arr = await open(store);
INFO
Bundlers like Rollup are smart enough to tree-shake namespace imports, so the above code will result in the same final bundle.