Installation

VirtualiZarr is available on PyPI via pip:

pip install virtualizarr

and on conda-forge:

conda install -c conda-forge virtualizarr

Optional dependencies

VirtualiZarr has many optional dependencies, split into those for reading various file formats, and those for writing virtual references out to different formats.

Optional dependencies can be installed in groups via pip. For example to read HDF files and write virtual references to icechunk you could install all necessary dependencies via:

pip install "virtualizarr[hdf, icechunk]"

The full list of optional dependencies from the pyproject.toml is shown below:

remote:

    fsspec

    requests

    aiohttp

    s3fs

hdf:

    h5py

    hdf5plugin

    imagecodecs

    imagecodecs-numcodecs==2024.6.1

netcdf3:

    virtualizarr[remote]

    kerchunk>=0.2.8

    scipy

fits:

    virtualizarr[remote]

    kerchunk>=0.2.8

    astropy

kerchunk_parquet:

    virtualizarr[remote]

    fastparquet

all_parsers:

    virtualizarr[hdf]

    virtualizarr[netcdf3]

    virtualizarr[fits]

    virtualizarr[kerchunk_parquet]

icechunk:

    icechunk>=0.2.4

kerchunk:

    fastparquet

all_writers:

    virtualizarr[icechunk]

    virtualizarr[kerchunk]

The compound groups allow you to install multiple sets of dependencies at once, e.g. install every file parser via

pip install "virtualizarr[all_parsers]"

The basic pip install virtualizarr will only install the minimal required dependencies, and so may not be particularly useful on its own.

Install Test Dependencies

For local development you will want to install the test dependencies so that you can run all the tests in the test suite:

pip install '-e .[test]'

Install Docs Dependencies

To build the documentation locally you will need further dependencies:

pip install '-e .[docs]'