API reference

Arrays

Zarr.zcreate Function

zcreate(T, dims...;kwargs)

Creates a new empty zarr array with element type T and array dimensions dims. The following keyword arguments are accepted:

• path="" directory name to store a persistent array. If left empty, an in-memory array will be created

• name="" name of the zarr array, defaults to the directory name

• zarr_format=Zarr.ZarrFormat{2}(Val{2}()) Zarr format version (2 or 3)

• storagetype determines the storage to use, current options are DirectoryStore or DictStore

• chunks=dims size of the individual array chunks, must be a tuple of length length(dims)

• fill_value=nothing value to represent missing values

• fill_as_missing=false set to true shall fillvalue s be converted to missings

• filters=filters to be applied

• compressor=BloscCompressor() compressor type and properties

• attrs=Dict() a dict containing key-value pairs with metadata attributes associated to the array

• writeable=true determines if the array is opened in read-only or write mode

• indent_json=false determines if indents are added to format the json files .zarray and .zattrs. This makes them more readable, but increases file size.

• dimension_separator='.' sets how chunks are encoded. The Zarr v2 default is '.' such that the first 3D chunk would be 0.0.0. The Zarr v3 default is /.

source

Create a new subarray of the group g

source

Zarr.zzeros Function

zzeros(T, dims...; kwargs... )

Creates a zarr array and initializes all values with zero. Accepts the same keyword arguments as zcreate

source

Group hierarchy

Zarr.zcreate Method

Create a new subarray of the group g

source

Zarr.zgroup Function

zgroup(s::AbstractStore; attrs=Dict())

Create a new zgroup in the store s

source

Zarr.zgroup Method

Create a subgroup of the group g

source

Zarr.zopen Function

zopen(s::AbstractStore, mode="r"; consolidated = false, path = "")

Opens a zarr Array or Group at Store s. If consolidated is set to "true", Zarr will search for a consolidated metadata field as created by the python zarr consolidate_metadata function. This can substantially speed up metadata parsing of large zarr groups. The expected zarr version can be supplied through zarr_format and defaults to :auto which tries to detect if the zarr version is v2 or v3.

source

Zarr.zopen Function

zopen(p::String, mode="r")

Open a zarr Array or group at disc path p.

source

Zarr.zopen_noerr Method

zopen_noerr(AbstractStore, mode = "r"; consolidated = false)

Works like zopen with the single difference that no error is thrown when the path or store does not point to a valid zarr array or group, but nothing is returned instead.

source

Compressors

Zarr.NoCompressor Type

NoCompressor()

Creates an object that can be passed to ZArray constructors without compression.

source

Zarr.BloscCompressor Method

BloscCompressor(;blocksize=0, clevel=5, cname="lz4", shuffle=1)

Returns a BloscCompressor struct that can serve as a Zarr array compressor. Keyword arguments are:

• clevel=5 the compression level, number between 0 (no compression) and 9 (max compression)

• cname="lz4" compressor name, can be one of "blosclz", "lz4", and "lz4hc"

• shuffle=1 Either NOSHUFFLE (0), SHUFFLE (1), BITSHUFFLE (2) or AUTOSHUFFLE (-1). If AUTOSHUFFLE, bit-shuffle will be used for buffers with itemsize 1, and byte-shuffle will be used otherwise. The default is SHUFFLE.

source

Zarr.ZlibCompressor Type

ZlibCompressor(clevel=-1)

Returns a ZlibCompressor struct that can serve as a Zarr array compressor. Keyword arguments are:

• clevel=-1 the compression level, number between -1 (Default), 0 (no compression) and 9 (max compression)

• default is -1 compromise between speed and compression (currently equivalent to level 6).

source

Zarr.ZstdCompressor Type

ZstdCompressor(;level=0, checksum=false)

Returns a ZstdCompressor struct that can serve as a Zarr array compressor. Keyword arguments are:

• level=0: the compression level, regular levels are 1 to 22, 0 is a special value for default, there are also even faster negative levels.

• checksum=false: flag to enable saving checksums.

source