Skip to content

Native and Extensible R Driver for 'Zarr'

1packages depend
3.9Kdownloads / year
53.6%test coverage
13/13flavors OK

Overview

About

The 'Zarr' specification is widely used to build libraries for the storage and retrieval of n-dimensional array data from data stores ranging from local file systems to the cloud. This package is a native 'Zarr' implementation in R with support for all required features of 'Zarr' version 3. It is designed to be extensible such that new stores, codecs and extensions can be added easily.

Changes in 1.0.0

This is the first stable release. This major release contains **API breaking changes** and the dependency on R has bumped to version 4.4.

Code has been refactored to make it more agile and less error-prone. Two major changes have been implemented:

1. The zarr_store class is no longer used in the public-facing API. Most store-oriented tasks are now handled through the zarr class, including creating a new store.

2. Instantiating a zarr_array will create it in the store if it does not yet exist, and attach itself to its parent, usually a zarr_group but it could also be a zarr instance in the case of a single-array store.

These changes impact the signature of several methods:

  • zarr$new() has several new arguments following the first store argument. All additional arguments are optional so existing code will remain functional. The store argument has additional functionality.
  • zarr_group$new() and zarr_array$new() no longer have the store argument.
  • Several other methods in these three classes have related signature changes, but these changes are not relevant for end users or application developers of this package.

Other new features:

  • Writing a zarr_array by indices can use [<-.zarr_array.
  • Can create a single array store.
  • New zarr$save_to() method can save a zarr object to a new store. This is handy to save a memory store to disk, to convert a v.2 store to a v.3 store, or to get a local copy of a remote store, among other uses. Parallel reads from HTTP and S3 stores speeds up the copying.
Show all changes in 1.0.0Hide the rest of the changes in 1.0.0
  • New zarr_array$details() method will produce a named character vector with a summary of the array.
  • New field zarr in class zarr_node to retrieve the zarr instance that manages the node.
  • Zarr v.2 filters as defined in Python's numcodecs are supported.
  • Printing to the console will use the cli package when installed. The theme used can be modified by the user.
  • User options can be saved to the user config directory using the save_options() function. They will be automatically loaded in all future sessions. Function reset_options() will reset the options to their default values.
  • The array_builder class has a field data_type_from_storage.mode that can make a Zarr data type from an R storage mode.
  • The separation between classes chunking and chunk_grid_regular is more robust. A new grid field will retrieve the chunk grid. The chunk grid will be printed to the console for arrays and the chunking scheme.
  • The glyph private field has moved from zarr_array to zarr_node such that zarr_group can have the same flexibility when printing.

Minor changes:

  • zarr.json writes arrays for shape and chunk_shape for 1D axes.
  • JSON writes use full numeric precision.
  • ref convention uses released version v2.0.0.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 3.6 min · r-devel-windows-x86_64
Status changes
  • OK13 OK2026-08-04
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK14 OK2026-03-10
Advisories

none known

Documentation

In release 1.0.0
READMEYes · 455 wordsVignettesNoNEWSYes · 100% structured · mentions 1.0.0Citation fileNoWebsiteYes · pkgdown

The repository also keeps web-only articles.

Help pages
65 (5 internal)includes a package overview page
Examples that run
100%18 run in a plain check (1 of them under a condition)
Exported functions with examples
38%
Documented parameters
93%
Return-value docs
52%
Help pages citing references
3%

Downloads

3.9K
CRAN downloads in the past year
Rank #6,762 · ~11/day · ~327/mo
Daily download trend is not available in this view yet.
39730 days
1.3K90 days
3.9K1 year
Compare downloads with other packages →
Also on213 r2u7 autocran

Repository

r-cf/zarr ↗Organization: R-CF
17Stars
1Forks
1Open issues
0Open PRs
7Releases
81Commits
1Commit identities
geozarrn-dimensional-arrayrzarr
81 commits · Last activity 2026-10-23 · 0% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
not measured
Median days to close, 50 most recently updated closed issues
2
Median days to close, 50 most recently updated closed PRs
not measured

Stars over time

2025-09-22 · 12026-09-06 · 17
PracticesBeta

9 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/r-cf/zarr on 2026-10-21.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-18 · The repository has a site deploy workflow

pkgdown site last built 2026-10-18, before release 1.0.0 (2026-10-23)

Coverage (1)
Coverage reporting
CRAN release process (1)
cran-comments.md
Show all practicesHide 1 practice
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v4 (2026-10-20)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2026-05-07
    Seen in the repository: CLAUDE.md
    Named in .Rbuildignore: .claude, CLAUDE.md
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
16 external dependencies (excludes base and recommended)

Installing zarr adds 5 packages (3 with compiled code, 3.3 MB of source tarballs). Heaviest: Rcpp 1.8 MB, jsonlite 1.0 MB, cpp11 298 KB.

Depends (1)
R >= 4.4
Imports (5)
LinkingTo (1)
Enhances (0)
none
Reverse dependencies
1direct
0indirect
Depends 1
Depends, Imports or LinkingTo, most downloaded first

People & History

People (1)
Author, Maintainer since 0.1.1 (2025), Copyright holder
Releases (9)

Pick two releases to compare their code metrics.

  • 1.0.0Latest
    record
    2026-10-23 · current release · diff ↗ ·
    added 3 exports
    auto_chunk, reset_options, save_options
    ·
    listed once in CRAN's queue
    Seen in one reading of CRAN's incoming queue, at 2026-10-23 11:11 UTC, so it stayed less than the time between readings.
  • 0.5.1
    record
    2026-09-08 · diff ↗
  • 0.5.0
    record
    2026-08-30 · diff ↗ ·
    added 4 exports
    optimal_chunking, s3_list_dir, zarr_object, zarr_s3store
  • 0.4.2
    record
    2026-07-11 · diff ↗ ·
    removed 2 exports
    zarr_conv_ref, zarr_conv_uom
    added 5 exports
    is_valid_node_name, zarr_convention_ref, zarr_convention_uom, zarr_localstore, zarr_options
  • 0.4.1
    record
    2026-06-14 · diff ↗
  • 0.4.0
    record
    2026-05-28 · diff ↗ ·
    added 1 export
    zarr_conventions
  • R
    R 4.6.0 released · 2026-04-24
  • 0.3.0
    record
    2026-04-18 · diff ↗ ·
    added 14 exports
    array_builder, zarr, zarr_array, zarr_conv_ref, zarr_conv_uom, zarr_convention, zarr_domain, zarr_domains, zarr_group, zarr_httpstore, zarr_memorystore, zarr_register_domain, zarr_store, zarr_unregister_domain
  • 0.2.0
    record
    2026-02-11 · diff ↗
  • 0.1.1
    record
    2025-12-06
  • R
    R 4.5.0 released · 2025-04-11
Across CRAN, the median accepted release of the past year spent 23 hours in the queue, 90% under 11 days.How queue time is measured

Package metadata

First published
2025-12-06
Total releases
9 / 1 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.4
Download size
2.7 MB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("zarr")
Van Laake, P. (2026). zarr: Native and Extensible R Driver for 'Zarr' (Version 1.0.0) [Computer software]. https://doi.org/10.32614/CRAN.package.zarr

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for zarr version 1.0.0 [Data set]. HJJB, LLC. Data release v2026-10-23. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-23, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy