Skip to main content

PyPI version tests

WavPack - numcodecs implementation

Numcodecs wrapper to the WavPack audio codec.

This implementation enables one to use WavPack as a compressor in Zarr.

Requirements

To install wavpack-numcodecs on MacOS, you need to install wavpack with brew:

brew install wavpack

For Linux and Windows, the package comes with pre-built binaries of the most recent version Wavpack version.

On Windows, you need to have the "Microsoft C++ Build Tools" installed. You can download it and install it from here.

On Linux, if an existing wavpack installation is found, the package will use it. Otherwise, it will use the pre-built binaries available in the wavpack_numcodecs/libraries folder.

WAVPACK_VERSION=5.8.0
wget "https://www.wavpack.com/wavpack-${WAVPACK_VERSION}.tar.bz2"
tar -xf wavpack-$WAVPACK_VERSION.tar.bz2
cd wavpack-$WAVPACK_VERSION
./configure
sudo make install
cd ..

Installation

Install via pip:

pip install wavpack-numcodecs

Or from sources:

git clone https://github.com/AllenNeuralDynamics/wavpack-numcodecs.git
cd wavpack_numcodecs
pip install .

Usage

This is a simple example on how to use the WavPackCodec with zarr:

from wavpack_numcodecs import WavPack

data = ... # any numpy array

# instantiate WavPack compressor
wv_compressor = WavPack(level=2, bps=None)

# v2
group = zarr.group()
z = group.create_dataset(name="wv_dset", data=data, compressor=wv_compressor)

# v3
zarr.config.set({"default_zarr_version": 3})
group = zarr.group()
z = group.create_array(name="wv_dset3", data=data, serializer=wv_compressor)

data_read = z[:]

Available **kwargs can be browsed with: WavPack?

NOTE 1: In order to reload in zarr an array saved with the WavPack, you just need to have the wavpack_numcodecs package installed.

NOTE 2: The Zarr v3 implementation is an ArrayBytesCodec. The zarr.create_array function only supports ArrayArrayCodec objects for filters and BytesBytesCodecs for compressors. Hence, we need to use the WavPack codec as a serializer, which is expected to be an ArrayBytesCodec object.

Developmers guide

How to upgrade WavPack installation and make a new release

To upgrade the WavPack installation, you need to:

  1. Download the latest version of WavPack from the official website.
  2. Extract the content of the downloaded file.
  3. Create a new folder in the src/wavpack_numcodecs/libraries folder with the name of the version of the WavPack you are installing.
  4. Add the Windows .dll and .lib files to the windows-x86_32 and windows-x86_64 folders, respectievely.
  5. Update the version of the CI workflows in the .github/wavpack_latest_version.txt file and set the LATEST_WAVPACK_VERSION variable in the setup.py to match the version of the WavPack you are installing.
  6. Make a PR with the changes and merge it.
  7. Manually trigger the Build wavpack binaries workflow in the Actions tab of the repository. This will automatically build the binaries for different Linux versions and make PRs with the changes to the main branch.
  8. Merge the automated PRs to update the Linux binaries.
  9. Update the version of the package in the pyproject.toml file and tag the repo to automatically make a new release.

Metadata

Release files for wavpack-numcodecs 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wavpack-numcodecs 0.3.1
File Size Uploaded Provenance Actions
wavpack_numcodecs-0.3.1.tar.gz 3.6 MB Without provenance Details for wavpack_numcodecs-0.3.1.tar.gz

Release files / wavpack_numcodecs-0.3.1.tar.gz

Download URL wavpack_numcodecs-0.3.1.tar.gz
Size 3.6 MB
Tags Source
SHA-256 checksum
How to use checksums
4b73a9736027299ec0e2874cedcdd95b08e84bd2caa287453d10297e1743e336
BLAKE2b-256 checksum
How to use checksums
2b12e28a8ac2dbaba35f985e257bf5b8decc34f9660b6e7ac94cc40b2741b190
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.17

Security for wavpack-numcodecs 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page