# Project information

## Releases

Source code and pre-built binaries (aka Python wheels) for Windows, MacOS and ManyLinux are available at the following places:

- Wheels and source code on PyPi

- Packages on conda-forge

For the history of modifications, see the Changelog.

## Project resources

- Source repository

- Issue tracker

hdf5plugin can be cited with its DOI: 10.5281/zenodo.7257761.

## Presentations

- Presentation at the European HDF Users Group (HUG) Meeting 2023:

  - Presentation material (`Notebook`), Video EuHUG2023

  - Benchmark: `script`, `display notebook`

  - HDF5 compressed chunk direct read example (`Notebook`)

- Presentation at the European HDF Users Group (HUG) Meeting 2022:

  - Presentation material (`Notebook`), Video EuHUG2022

- Presentation at the European HDF Users Group (HUG) Summer 2021:

  - Presentation material (`Notebook`), Video EuHUG2021

## HDF5 filters and compression libraries

HDF5 compression filters and compression libraries sources were obtained from:

- LZ4 plugin (commit 49e3b65) using LZ4.

- bitshuffle plugin (v0.5.2) using LZ4 and ZStd.

- bzip2 plugin (from PyTables v3.10.2) using BZip2 (v1.0.8).

- hdf5-blosc plugin (v1.0.1) using c-blosc (v1.21.6), LZ4, Snappy, ZLib and ZStd.

- hdf5-blosc2 plugin (from PyTables v3.10.2) using c-blosc2 (v2.17.1), LZ4, ZLib and ZStd.

- FCIDECOMP plugin (v2.1.1) using CharLS (v2.1.0).

- SZ plugin (commit f466775) using SZ, ZLib and ZStd.

- H5Z-SPERR plugin (v0.2.3) using SPERR (v0.8.2).

- SZ3 plugin (commit 4bbe9df7e4bcb) using SZ3 and ZStd.

- HDF5-ZFP plugin (v1.1.1) using zfp (v1.0.1).

- HDF5Plugin-Zstandard (commit d5afdb5) using ZStd.

Sources of compression libraries shared accross multiple filters were obtained from:

- LZ4 v1.10.0

- Snappy v1.2.1

- ZStd v1.5.6

- ZLib v1.3.1

When compiled with Intel IPP, the LZ4 compression library is replaced with LZ4 v1.9.3 patched with a patch from Intel IPP 2021.7.0.

## License

The source code of hdf5plugin itself is licensed under the MIT license. Use it at your own risk. See LICENSE.

The source code of the embedded HDF5 filter plugin libraries is licensed under different open-source licenses. Please read the different licenses:

- bitshuffle: See src/bitshuffle/LICENSE

- blosc: See src/hdf5-blosc/LICENSES/, src/c-blosc/LICENSES/ and src/snappy/COPYING

- blosc2: See src/PyTables/LICENSE.txt and src/c-blosc2/LICENSES/

- bzip2: See src/PyTables/LICENSE.txt and src/bzip2/LICENSE

- lz4: See src/LZ4/COPYING, src/LZ4/LICENSE and src/c-blosc/LICENSES/LZ4.txt

- FCIDECOMP: See src/fcidecomp/LICENSE and src/charls/LICENSE.md

- SPERR: See src/H5Z-SPERR/LICENSE and src/SPERR/LICENSE

- SZ: See src/SZ/copyright-and-BSD-license.txt

- SZ3: See src/SZ3/copyright-and-BSD-license.txt

- zfp: See src/H5Z-ZFP/LICENSE and src/zfp/LICENSE

- zstd: See src/HDF5Plugin-Zstandard/LICENSE

The HDF5 v1.10.5 headers (and Windows .lib file) used to build the filters are stored for convenience in the repository. The license is available here: src/hdf5/COPYING.