Skip to main content

Napari plugin to store set of layers in a .h5 file. Label layer are stored in a sparse representation

Project description

napari-hdf5-labels-io

License PyPI Python Version tests codecov

napari plugin to store napari projects in a .h5 file. Label layer are stored in a sparse representation (COO list).


This napari plugin was generated with Cookiecutter using with @napari's cookiecutter-napari-plugin template.

Description

This napari plugin provides a writer and reader to store existing layers in the current napari window, all the metadata is stored as well in a HDF5 file. All the stored preferences are included when a project file is opened.

Label layers are stored in a coordinate list sparse representation with the Sparse module to keep the project file size minimum when possible (aiming to implement this in other layers in the future).

HDF5 file architecture

The project file is a HDF5 generated with the h5py module. The file groups correspond to the different napari layer types and the layer metadata is stored as attributes of each layer.

In the case of the meta dictionary which is nested in the LayerData meta dictionary (napari IO), new keys are generated in the outer dictionary to use them as h5 dataset attributes. This nested dictionary architecture is reconstructed by the reader to ensure format compatibility.

Installation

You can install napari-hdf5-labels-io via pip:

pip install napari-hdf5-labels-io

Contributing

Contributions are very welcome. Tests can be run with tox, please ensure the coverage at least stays the same before you submit a pull request.

License

Distributed under the terms of the GNU GPL v3.0 license, "napari-hdf5-labels-io" is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

napari-hdf5-labels-io-0.2.dev23.tar.gz (30.2 kB view hashes)

Uploaded Source

Built Distribution

napari_hdf5_labels_io-0.2.dev23-py3-none-any.whl (20.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page